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ABSTRACT 


The  Naval  Security  Group  currently  requires  a  modem  architecture  to  merge 
existing  command  databases  into  a  single  Enterprise  Information  System  through  which 
each  command  may  manipulate  administrative  data.  There  are  numerous  technologies 
available  to  build  and  implement  such  a  system.  Component-based  architectures  are 
extremely  well-suited  for  creating  scalable  and  flexible  three-tier  Client/Server  systems, 
because  the  data  and  business  logic  are  encapsulated  within  objects,  allowing  them  to  be 
located  anywhere  on  a  network.  The  first  tier  represents  the  visual  aspects  of  the  data  on 
the  client  side.  The  middle  tier  consists  of  server  objects  that  represent  the  persistent  data 
and  enforce  the  business  logic  functions.  The  third  tier  maintains  the  database 
management  systems.  The  client  interacts  with  the  middle-tier  server  objects  via 
Common  Object  Request  Broker  Architecture.  CORBA  provides  a  language  and 
platform  independent  architecture  that  enables  objects  to  transparently  make  requests  and 
receive  responses  in  a  distributed  environment.  Java  is  an  object-oriented,  multi¬ 
threaded,  secure  mobile  code  system  that  allows  applications  to  run  on  all  major 
computing  platforms.  This  thesis  examines  the  design  of  an  EIS  using  Java  applets  that 
use  Inter-Orb  Protocol  to  communicate  with  CORBA  middle-tier  server  objects.  The 
third  tier  will  incorporate  Java  Database  Connectivity  to  communicate  with  database 
management  systems. 
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1. 


INTRODUCTION 


A.  BACKGROUND 

The  United  States  Naval  Security  Group  (NSG),  in  its  present  state,  lacks  the 
automated  information  infrastructure  required  to  efficiently  process  its  administrative 
data.  This  hinders  NSG's  ability  to  rapidly  make  decisions  based  on  this  administrative 
information.  The  lack  of  an  adequate  information  infrastructure  results  in  redundant  and 
imprecise  data  maintained  at  different  field  sites.  This  ultimately  leads  to  a  waste  of 
computer  resources,  manpower  and  time.  Due  to  downsizing  and  budget  cuts,  our 
modem  Navy  is  consistently  required  to  "do  more  with  less".  An  Enterprise  Information 
System  is  a  distributed  architecture  model  that  allows  organizations  to  access  and 
manipulate  data  via  a  network  medium.  An  Enterprise  Information  System  will  greatly 
benefit  the  Naval  Security  Group  in  manpower  and  expenditure  reductions. 

Preliminary  studies  were  performed  utilizing  a  PC-based  system.  Common 
Gateway  Interface  (CGI)  scripting  and  Microsoft  products  by  LCDR  James  Stevenson 
[Ref:  1].  From  his  research,  a  prototype  was  designed  and  built  to  show  the  feasibility  of 
implementing  an  EIS  using  Commercial  Off  The  Shelf  (COTS)  hardware  and  software. 

CGI  scripting  used  by  [Ref:  1]  has  serious  limitations  for  implementing  a 
Client/server  EIS.  CGI  scripts  spawn  a  new  process  every  time  a  connection  request  is 
received.  This  brings  an  enormous  performance  penalty,  because  there  is  no  way  to 
provide  scalability  and  load  balancing  with  CGI  scripting.  In  addition,  CGI  scripting  is 
not  designed  for  a  fiill-scale  Client/Server  application  in  mind.  There  are  a  ntmiber  of 
proposed  solutions  to  overcome  the  inefficiencies  of  CGI  scripting.  The  latest  advances 
in  this  field  center  around  component  based  middleware  that  makes  optimum  use  of 
network  and  hardware  resources.  The  focus  of  this  thesis  will  be  to  choose  what  we 
deem  “the  best”  of  these  component  based  technologies  and  use  it  to  implement  an  EIS. 
From  these  technologies,  a  prototype  will  be  designed  and  built  on  an  open  network 
Client/Server  environment.  The  primary  research  objective  of  this  research  is  to  provide 
an  object-oriented  web-based  data  retrieval  system  that  can  be  used  as  a  proof  of  concept 
for  our' proposed  NSG  EIS. 
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W.e  will  try  to  answer  the  following  questions: 


•  What  is  the  most  effective  and  efficient  approach  to  build  a  “real  time” 
Enterprise  Information  System,  in  accordance  with  IT-21  architecture,  that 
will  meet  the  needs  of  the  Naval  Security  Group  (NAVSECGRU)? 

•  What  are  the  advantages  and  disadvantages  of  accessing  a  Database  via  the 
Internet  utilizing  Common  Object  Request  Broker  Architecture  (CORBA)  and 
JDBC? 

B.  SCOPE 

The  scope  of  our  thesis  is  to  design  and  implement  a  component-based  Enterprise 
Information  System  prototype  for  NSG.  First  we  will  provide  a  detailed  definition  of  an 
EIS.  In  the  second  step  we  will  examine  various  Client/Server  configurations  to 
determine  which  model  meets  NSG  requirements.  We  will  then  give  the  user  the 
appropriate  background  information  for  using  Java  and  JDBC  as  a  means  of  database 
connectivity.  Java  will  be  used  as  the  implementation  language  for  our  EIS  prototype. 
Information  will  be  provided  about  the  Common  Object  Request  Broker  Architecture  and 
its  services,  which  forms  the  basis  for  the  interaction  between  different  components  in 
EIS.  Then  we  will  begin  describing  the  EIS  prototype  that  we  have  built.  The  design  of 
the  EIS  prototype  and  implementation  issues  will  be  discussed.  Next  we  will  set  up  the 
hardware  and  implement  the  prototype.  And  finally,  we  will  summarize  the  lessons 
learned  and  recommended  future  work. 

Our  EIS  prototype  will  be  constructed  in  accordance  with  IT-21  specifications 
and  will  provide  a  cost-effective  solution  for  the  Naval  Security  Group  automated 
information  infrastructure. 

C.  ORGANIZATION  OF  THESIS 

This  thesis  is  organized  into  the  following  chapters: 
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•  Chapter  I:  Introduction.  This  chapter  gives  an  overview  of  the  problem, 
justification,  purpose  and  basic  structure  of  the  thesis. 

•  Chapter  II:  Enterprise  Information  System.  This  chapter  provides  the  specific 
concepts  of  what  a  modem  EIS  should  be.  An  explanation  of  the  EIS 
backgroimd  history,  characteristics,  hardware  and  software  will  be  provided. 

•  Chapter  III:  Relational  Databases  and  the  Structured  Query  Language.  This 
chapter  describes  a  Relational  Database  Management  System  (RDBMS)  and 
the  Structured  Query  Language  (SQL)  required  to  access  it.  RDBMS  and 
SQL  formulate  the  backbone  of  our  Enterprise  Information  System  prototype. 

•  Chapter  IV:  Client/Server  Architecture.  In  this  chapter  we  provide  an 
overview  of  one-tier,  two-tier,  three-tier  and  n-tier  Client/Server  architectures 
that  can  be  used  in  implementing  an  EIS.  These  architectures  will  be 
explained  in  detail,  to  include  the  advantages  and  disadvantages  of  using  each. 
Emphasis  will  be  placed  on  the  three-tier  Client/Server  system  on  which  our 
EIS  prototype  is  built 

•  Chapter  V:  Java  and  JDBC.  Java  and  the  JDBC  package  provide  the 
developers  of  an  EIS  a  concise  and  efficient  way  to  access  and  manipulate 
data  stored  in  a  RDBMS.  The  interaction  between  the  server  and  back-end 

'  data  sources  of  our  EIS  prototype  is  based  on  JDBC.  We  have  used  the 
methods  defined  in  the  JDBC  package  to  execute  the  queries  requested  by  the 
user  of  the  EIS  on  the  back-end  database  server.  This  chapter  will  describe 
how  to  use  Java  and  JDBC  to  provide  this  type  of  interaction.  It  will  outline 
the  JDBC  API,  classes,  methods,  and  how  they  can  be  used  by  applications  to 
directly  access  a  RDBMS. 

•  Chapter  VI:  Common  Object  Request  Broker  Architecture.  CORBA  is  an 
industry-wide  standard  for  developing  robust  distributed  systems.  The. 
interaction  between  the  client  and  the  server  components  of  our  EIS  prototype 
is  built  using  the  CORBA  architecture  model.  This  chapter  will  provide  the 
user  with  a  broad  overview  of  CORBA,  CORBA  Services,  CORBA  Facilities 
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and  why  CORBA  is  an  excellent  COTS  technology  for  a  web-based 
Client/Server  Enterprise  Information  System. 

•  Chapter  VII:  Implementation  of  a  Web  Based  Client/Server  System  using 
CORBA  and  JDBC.  This  chapter  takes  the  reader  through  an  application 
design  process  with  CORBA  and  then  describes  the  convention  of  applets  as 
an  interface  to  a  CORBA  Client/Server  system.  Next,  the  design  and 
implementation  details  of  our  EIS  prototype  are  discussed  and  sample 
diagrams  are  provided. 

•  Chapter  VIII:  Conclusions.  This  chapter  will  give  directions  on  how  to 
enhance  the  prototype  that  is  built  and  provide  the  reader  with  an  assessment 
of  the  maturity  and  performance  of  CORBA  in  an  EIS. 
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II.  ENTERPRISE  INFORMATION  SYSTEMS 


The  term  Enterprise  Information  Systems  (EIS)  or  Executive  Information  Systems 
was  first  used  at  Massachusetts  Institute  of  Technology  (MIT)  in  the  late  1970s.  The 
concept  spread  gradually  into  dozens  of  large  corporations.  A  study  conducted  by  the 
MIT  Center  for  Information  Systems  Research,  revealed  that  in  1985,  about  one  third  of 
U.S.  corporations  had  some  kind  of  EIS  installed  or  under  installation.  [Ref:  2]  The 
implementation  of  an  EIS  will  allow  for  the  reduction  of  personnel  and  computer 
resources  required  to  support  multiple  queries  for  each  command  in  the  Naval  Security 
Group.  In  addition,  an  EIS  will  eliminate  the  resources  drain  on  NAVSECGRU  systems 
when  executing  long-running,  complex  queries. 

EIS  utilize  newer  computer  technology  in  the  form  of  data  sources,  hardware  and 
programs  to  place  data  in  a  common  format  and  provide  fast  and  easy  access  to 
information  via  the  Internet.  Our  EIS  prototype  is  tailored  to  the  needs  and  preferences 
of  NAVSECGRU  and  information  is  presented  in  a  format  that  can  most  readily  be 
interpreted. 

Traditionally,  Enterprise  Information  Systems  were  developed  as  mainframe 
computer-based  programs.  The  intent  was  to  present  key  organizational  data  for 
decision-makers  that  are  not  well  acquainted  with  computers.  The  first  programs  were 
proprietary  and  very  expensive.  They  pulled  data  from  mainframe  systems  and 
simplified  it  to  graphically  illustrate  key  performance  indicators.  The  objective  was  to 
develop  computer  applications  that  would  address  the  information  needs  of  senior 
personnel. 

Today's  generation  of  EIS  is  aimed  at  a  broader  audience  and  the  application  goes 
well  beyond  the  boundaries  of  typical  organization  hierarchies.  EIS  are  now  installed  at 
the  personal  computer  or  workstation  level  on  Local  Area  Networks  (LAN).  Enterprise 
Information  Systems  take  advantage  of  the  Client/Server  environment,  where  each 
person's  personal  computer  has  access  to  organizational  data  and  decides  which  data  are 
needed  to  perform  their  job  fimctions.  This  arrangement  provides  the  capability  for  all 
users  to  customize  their  access  to  the  appropriate  organizational  data  and  provide  relevant 
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information  up  the  chain  of  command  as  well  as  down,  thereby  providing  timely  and  up 
to  date  data  required  by  decision-makers  at  the  command  and  fleet  levels. 

The  recent  expansion  of  the  World  Wide  Web  (WWW)  has  enhanced  its  use  as  a 
medium  for  the  dissemination  of  database  information.  This  is  due  to  the  relatively 
inexpensive  and  maintenance  free  aspects  of  the  Internet.  Perceivably  it  makes  sense  to 
utilize  this  medium,  thereby  decreasing  the  costs  of  building  and  maintaining  an  EIS. 

An  EIS  has  many  distinct  features  that  differentiate  it  from  other  applications 
software.  A  list  of  these  features  is  presented  in  Table  2.1.  A  successful  Enterprise 
Information  System  minimizes  hard  copy  reports  while  keeping  various  branches  of  the 
organization  up  dated. 


Description 

Degree  of  use 

High,  consistent,  without  need  of 

technical  assistance 

Computer  skills  required 

Very  low  —must  be  easy  to  learn  and  use 

Flexibility 

High 

Principle  use 

Tracking,  control,  sharing  data 

Decisions  supported 

Management 

Data  supported 

Internal  and  external  data 

Output  capabilities 

Text,  tabular,  graphical 

Graphic  concentration 

High,  presentation  style 

Data  access  speed 

Must  be  high,  fast  response  time 

Table  2.1:  Characteristics  typical  of  an  Enterprise  Information  System  [Ref:  2] 


Advanced  internal  control  and  communications  are  typical  focuses  of  an  EIS.  An 
EIS  allows  access  to  external  as  well  as  internal  information  as  shown  in  Table  2.2.  Both 
types  of  data  play  a  vital  role  in  decisions  made  by  users  of  an  EIS.  It’s  the  inclusion  of 
these  factors,  both  internal  and  external  to  NAVSECGRU  that  will  drive  the  successful 
deployment  of  an  EIS  in  the  cryptologic  community. 
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.-Internal, ' 

,'E?Iern^ 

Need  for  timely  information 

Need  to  downsize  organizations 

Need  for  improved  communication 

Rapidly  changing  operational 

environment 

Need  for  access  to  operational  data 

Need  to  access  external  databases 

Need  for  rapid  updates  from  different 

commands 

Need  to  proactively  approach  external 

enviromnent 

Need  to  access  command  personnel 

databases 

Increasing  Government  regulations 

Table  2.2:  Factors  that  contribute  to  the  development  of  an  EIS  [Ref:  2] 


With  the  increasing  requirement  for  information  flow  at  the  command  level,  the 
importance  of  Enterprise  Information  Systems  is  increasing.  An  indication  of  this,  is  the 
large  expenditure  on  EIS  development  projects  within  the  DOD  and  the  subsequent 
operation  of  such  systems.  Initially  only  large  corporate  organizations  could  afford 
having  an  EIS.  However,  as  EIS  building  blocks  become  cheaper  and  tools  become  more 
readily  available,  this  type  of  system  is  becoming  affordable  for  a  larger  number  of 
organizations. 

The  latest  trend  in  EIS  development  is  toward  the  utilization  of  rapid  application 
development  tools  to  design  reusable  components.  This  provides  the  capability  to  replace 
any  component  of  the  system  when  an  improved  version  becomes  available.  In  other 
words,  it  is  relatively  easy  to  perform  a  version  upgrade  to  your  current  database  server, 
or  to  switch  database  servers  simply  by  changing  only  a  few  lines  of  code.  This  will  also 
provide  the  added  advantage  of  keeping  the  EIS  up  to  date  with  advances  in  technology. 

1.  Hardware 

Since  an  integrated  system  requires  fairly  large  amounts  of  storage  space,  most 
EIS  originally  were  developed  as  mainframe  computer  solutions.  A  mainframe  EIS 
requires  computer  personnel  to  develop  and  maintain  the  system.  These  systems  are  very 
expensive,  and  their  use  is  usually  limited  to  top-level  executives  in  the  organization. 
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With  the  advent  of  Local  Area  Network  technology  as  well  as  the  expansion  of  the 
Internet,  several  EIS  products  for  networked  workstations  have  become  available.  These 
systems  have  the  advantage  of  requiring  less  support  and  less  expensive  computer 
hardware.  They  also  increase  access  of  the  EIS  information  to  many  more  users  within 
the  organi2ation.  EIS  have  migrated  from  mainframe  computers  to  personal  computers 
(PC)  cormected  by  a  LAN  and  comprised  of  midrange  computers  that  act  as  servers  to  the 
network.  The  midrange  computer  is  more  powerful  than  the  PC  in  terms  of  processing 
capability  and  also  has  the  ability  to  integrate  multiple  databases.  The  advantages  of  the 
PC  are: 

•  Efficient  data  summarization 

•  More  user  friendly  than  mainframe  computers 

•  Better  graphic  capabilities  than  mainframe  computers 

•  Affordability  (the  client  can  be  configured  less  expensively  using  PC 
architecture) 


The  best  architecture  solution  will  optimize  the  capabilities  of  the  PC  and  the 
midrange  computer.  It  is  truthful  to  say  that  the  best  EIS  architecture  solution  will  be 
built  around  open-network  Client/Server  systems.  Some  of  the  benefits  of  the 
Client/Server  architecture  are: 


•  Client/Server  systems  provide  multiple  views  of  data  regardless  of  the  data 
format. 

•  Client/Server  systems  reduce  investment  in  computer  hardware. 

•  They  establish  a  flexible  system  that  can  change  and  expand  as  operational 
requirements  change,  responding  to  a  dynamic  environment  and  to  the  needs 
of  users  at  all  levels. 
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•  They  remove  barriers  across  the  organization. 

•  They  allow  upper  management  to  manage  with  real-time  data,  resulting  in 
more  informed  decisions. 

The  future  of  Enterprise  Information  Systems  will  lie  in  the  successful  migration 
away  from  mainframe  computer  systems.  This  will  eliminate  the  need  to  learn  different 
computer  operating  systems  and  reduce  the  overall  cost  of  implementation.  This  trend 
will  also  utilize  existing  COTS  software  applications  and  minimize  the  need  to  learn  a 
new  or  special  language  for  the  EIS  package.  New  Enterprise  Information  Systems  will 
exist  on  personal  computers  and  make  use  of  Windows  open  systems  computing  and, 
component  based  object-oriented  programming.  These  systems  are  easier  to  build  and 
maintain  and  are  less  expensive  than  existing  EIS.  In  addition,  these  systems  provide 
access  to  organization  and  external  information  through  visual  screens  that  combine  text, 
numerical  data,  graphical  data  and  images.  The  visual  screens  will  provide  users  With 
quick  and  easy  access  to  data,  thereby  improving  their  decision-making  capabilities. 

2.  Software 

Software  designed  to  directly  manipulate  data  is  an  important  tool  in  designing  an 
effective  EIS.  Therefore,  the  software  components  and  how  they  integrate  the  data  into 
one  system  are  very  important. 

The  data  supplied  to  an  EIS  can  be  obtained  from  several  different  sources.  The 
most  common  sources  are  databases  residing  on  a  range  of  vendor-specific  and  open 
computer  platforms.  The  primary  activities  regarding  the  database  information  will  be 
inserting  data,  modifying  current  data,  and  querying  stored  data. 

The  structure  of  the  database  determines  the  method  of  access.  Most  database 
systems  maintained  by  tiie  DOD  use  relational  design  architecture.  The  advantages  of 
this  structure  are  that  they  can  be  easily  expanded  or  updated,  are  simple  to  use,  and  can 
be  accessed  in  several  different  formats.  The  relational  database  provides  the  flexibility 
that  is  especially  valuable  in  the  distributed  or  Client/Server  environment.  Almost  all 
databases  have  extensions  to  allow  for  access  via  the  Internet. 
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3.  Interface 


From  the  users  perspective  an  EIS  is  the  interface.  In  other  words,  all  that  the 
user  will  see  is  the  Graphical  User  Interface  (GUI)  component  of  an  EIS,  which  is 
comprised  of  an  applet  in  our  prototype.  Therefore,  when  designing  the  interface, 
emphasis  should  be  placed  on  usability  and  simplicity  (i.e.  the  “Front-end”).  The  ideal 
interface  for  an  EIS  would  have  the  following  properties: 

•  Ease  of  use 

•  Be  consistent  with  the  mission  of  the  organization. 

•  Provide  informative  and  explanatory  error  messages 

•  Be  highly  flexible,  in  order  to  handle  users  at  all  levels  of  computer 


proficiency 

The  various  types  of  interfaces  available  for  an  EIS  are  shown  in  Table  2.3. 


Type 

Description 

Scheduled  reports 

Batch-oriented 

Predefined,  prepared  reports 

Not  flexible 

No  interaction  required 

Questions/answers 

Interactive  Ad  hoc  in  nature 

Menu-driven 

User  fnendly  Step-by-step  procedures 

Natural  language 

Regular  English  is  used  to  interact  with 

the  EIS 

Input/output 

Predefined  data/information 

relationships  are  known  by  the  user 

Table  2.3:  Types  of  interfaces  available  to  the  EIS  [Ref:  2] 
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4.  Telecommunications 


The  current  trend  in  organizations  is  to  decentralize  operations. 
Telecommunications  will  play  a  pivotal  role  in  many  networked  information  systems  due 
to  this  trend.  A  reliable  network  is  necessary  to  transmit  data  from  one  site  to  another. 
The  requirement  for  quick  access  to  distributed  data,  increases  the  importance  of 
telecommunications  within  an  EIS. 

A  successful  Enterprise  Information  System  should  have  the  following  traits: 

•  It  should  be  easily  accessible  by  all  users  in  an  organization 

•  Easy  for  the  novice  user  to  operate 

•  It  should  be  flexible  regarding  hafdware/software  modifications 

•  It  should  be  relatively  inexpensive  to  build  and  maintain 

•  It  should  be  PC  based  to  cut  down  on  costs  and  the  system  should  be  built  to 
allow  for  quick  and  affordable  upgrades  to  stay  up  to  date  with  changes  in 
technology. 

An  EIS  within  the  Naval  Security  Group  will  provide  for  the  easy  and  rapid 
dissemination  of  data.  In  addition,  the  Naval  Security  Group  will  greatly  profit  in 
reduced  man-hours  and  computer  resources  by  implementing  this  architecture.  The 
following  chapters  will  give  the  reader  the  background  information  required  to 
understand  and  analyze  our  sample  Enterprise  Information  System,  which  was 
implemented  using  JDBC  and  Common  Object  Request  Broker  Architecture  (CORBA). 
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III.  RELATIONAL  DATABASES  AND  THE  STRUCTURED  QUERY 

LANGUAGE 


A  database  is  a  logically  unified  collection  of  data  that  has  some  inherent  meaning 
and  represents  some  aspect  of  the  real  world.  In  addition,  a  database  is  designed  and  built 
to  accomplish  a  specific  requirement  of  an  organization  or  individual.  For  example,  the 
data  that  is  related  to  the  inventory  of  a  military  supply  center  could  be  stored  in  a 
database. 

A  Database  Management  System  (DBMS)  is  comprised  of  programs  that  enable 
users  to  perform  the  following: 

•  Define  a  database  —  this  involves  specifying  data  types,  structures,  and 
constraints  for  the  data  to  be  stored  in  the  database. 

•  Construct  a  database  -  is  the  process  of  storing  the  data  on  a  storage 
medium  controlled  by  the  DBMS . 

•  Manipulate  a  database  -  includes  functions  such  as  querying  the  database, 
updating  the  database,  and  generating  reports  from  the  data. 

A  Database  Management  System  is  simply  a  COTS  application  that  can  easily  be 
installed  and  used  on  all  types  of  computer  systems. 

Within  the  realm  of  Database  Engineering  there  are  four  basic  types  of  databases: 
Relational,  Network,  Hierarchical  and  Object-oriented  databases.  The  most  popular  type 
in  use  today  is  the  Relational  database  model.  Therefore,  the  focus  of  this  chapter  and  the 
implementation  of  our  prototype  will  be  the  Relational  database  model.  The  Relational 
database  model  is  based  on  a  simple  and  uniform  data  structure  called  a  relation.  Each 
relation  is  defined  as  a  table  of  values.  Within  a  table,  each  row  is  called  a  tuple  and 
represents  a  unique  value  in  the  database.  In  addition,  each  table  must  have  a  unique 
column  value  called  a  primary  key  that  is  used  to  identify  tuples  in  the  relation.  Any 
column  that  is  part  of  a  primary  key  cannot  be  null.  This  rule  is  referred  to  as  entity 
integrity.  Table  3.1  illustrates  a  relational  database  table. 
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DepartmentNumber 

DepartmentName 

ManagerName 

32001 

Operations 

Ted  Thompson 

32012 

Budgeting 

Mark  Bodine 

32014 

Research 

Ted  Thompson 

Table  3.1:  Relational  Database 


In  the  table  above,  each  column  represents  a  different  attribute  of  a  department. 
Each  row  represents  a  different  department.  The  DepartmentNumber  attribute  is  unique 
for  each  department,  so  it  is  chosen  as  a  primary  key. 

Foreign  keys  are  used  to  define  relationships  between  tables.  A  foreign  key  in 
one  table  is  a  reference  to  a  primary  key  in  another  table.  A  tuple  that  refers  to  another 
tuple  must  refer  to  an  existing  tuple  in  that  relation.  This  rule  is  referred  to  as  referential 
integrity.  In  the  sample  table  above,  the  ManagerName  attribute  is  chosen  as  a  foreign 
key,  because  it  refers  to  a  imique  row  of  data  in  the  Manager  table,  which  has  this  value 
as  its  primary  key. 

Designing  a  relational  database  involves  deciding  which  attributes  belong  to  a 
relation,  choosing  proper  names  for  the  columns  of  the  table,  specifying  the  data  types 
and  domains  of  these  attributes,  choosing  primary  keys  and  specifying  relations  between 
the  tables  by  the  use  of  foreign  keys. 

SQL  is  a  comprehensive  database  language  designed  for  use  with  relational 
databases.  It  has  statements  for  data  definition,  query  and  update.  SQL  consists  of  a  set 
of  standard  commands  that  can  be  understood  by  all  compliant  Relational  Database 
Management  Systems  (RDBMS).  The  following  is  a  list  of  more  commonly  used  SQL 
commands. 

1.  Data  Definition  Language: 

The  following  commands  are  used  to  create  or  modify  tables  and  other  database 
objects  and  are  used  extensively  in  our  prototype. 
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•  CREATE  TABLE  -  this  command  is  used  to  create  a  table  with  the  name  of 
the  table  and  columns  provided  by  the  user.  The  following  is  the  command 
used  to  define  a  table  with  the  name  Department: 

CREATE  TABLE  Department 

(DepartmentName  VARCHAR(10)  NOT  NULL, 

ManagerName  CHAR  (15)  NOT  NULL, 

DepartmentNumber  INT  NOT  NULL, 

PRIMARY  KEY  (DepartmentNumber), 

FOREIGN  KEY  (ManagerName)  REFERENCES  Manager  (Name)); 

•  DROP  TABLE  -  this  command  is  used  to  delete  a  table  definition  and  all 
rows  in  the  table.  The  following  is  the  command  used  to  delete  the  table 
defined  in  the  previous  example: 

DROP  TABLE  Department; 

•  ALTER  TABLE  -  the  definition  of  a  table  can  be  changed  by  using  this 
command.  It  is  possible  to  add  or  drop  a  column,  change  a  column  definition, 
or  add/remove  constraints  defined  for  the  table.  The  following  example 
shows  the  command  used  to  add  another  column  to  the  Department  table 
defined  above. 

ALTER  TABLE  Department  ADD  ManagerStartDate  DATE; 


2.  Data  Manipulation  Language: 

The  following  commands  are  used  to  insert,  delete,  query  and  display  data  from  a 
RDBMS.  These  commands  are  used  extensively  in  our  prototype. 
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•  SELECT  —  This  is  the  most  commonly  used  SQL  command  and  is  used  to 
query  the  database  and  display  selected  data  to  the  user.  We  have  used 
SELECT  queries  to  retrieve  data  from  the  database  that  met  the  search  criteria 
in  our  EIS  prototype.  The  name  of  the  table  from  which  the  data  is  to  be 
extracted  from  and  the  names  of  the  columns  should  be  specified  in  the  query. 
The  following  is  a  sample  SELECT  query. 

SELECT  DepartmentName,  DepartmentNumber 
FROM  Department 

WHERE  ManagerName  =  ‘John  Lewis’; 

•  INSERT  -  INSERT  commands  are  used  to  add  new  rows  to  a  table.  It  can  be 
used  to  fill  a  new  table  with  data  or  add  new  data  to  an  already  existing  table. 
When  the  user  of  the  EIS  performs  an  operation  to  input  new  data  in  to  the 
database  the  request  is  carried  out  by  means  of  an  INSERT  query.  The 
example  below  adds  new  department  to  the  table  defined  above. 

INSERT  INTO 

Department  (DepartmentName,  ManagerName,  DepartmentNumber) 
VALUES  (“Research”,  "John  Lewis”,  32015); 

•  DELETE  -  This  commeind  removes  a  single  row  or  rows  of  data  that  meet  the 
condition  specified.  The  following  query  can  be  used  to  delete  the  department 
whose  manager  is  “John  Lewis”. 

DELETE  FROM  Department 
WHERE  ManagerName  =  ‘John  Lewis’; 

•  UPDATE  -  This  command  is  used  to  modify  a  single  column  or  columns  of 
data  in  the  row  that  meets  the  condition  specified.  UPDATE  queries  are  used 
in  the  EIS  to  modify  existing  data  in  the  back-end  database.  The  following 
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query  can  be  used  for  example  to  change  the  manager  name  of  the  department 
that  has  a  DepartmentNumber  of  32014. 

UPDATE  Department 

SET  ManagerName  =  ‘Johnson’ 

WHERE  DepartmentNumber  =  32014; 

There  are  a  variety  of  ways  to  use  SQL  to  define  and  manipulate  data  in  a 
Database  Management  System.  One  way  is  to  embed  SQL  statements  in  a  high-level 
programming  language.  This  is  called  Embedded  SQL.  Embedded  SQL  allows 
programmers  to  place  SQL  statements  into  the  host  language.  SQL  statements  are 
delimited  with  specific  starting  and  ending  statements  defined  by  the  language.  When 
compiling  a  program  with  embedded  SQL  statements,  a  precompiler  translates  these 
statements  into  equivalent  host  language  source  code.  After  precompiling,  the  host 
language  compiler  compiles  the  resulting  source  code.  The  SQL  statements,  that  were 
extracted,  form  a  database  module  that  is  parsed,  validated  and  executed  by  the  DBMS. 

Another  way  to  execute  SQL  statements  is  to  have  pre-defined  and  compiled 
procedures,  which  reside  on  the  database  and  can  be  called  by  clients.  These  procedures 
are  commonly  referred  to  as  stored  procedures.  Stored  procedures  offer  many  benefits 
when  the  query  to  be  executed  is  large  and  complex.  The  following  is  a  list  of  these 
benefits: 

•  After  a  stored  procedure  is  executed  for  the  first  time,  it  does  not  need  to  be 
parsed,  optimized  or  compiled  again. 

•  Stored  procedures  can  consist  of  multiple  queries,  but  can  be  executed  with  a 
single  statement,  thus  reducing  network  traffic. 

•  Stored  procedures  accept  input  parameters  so  that  multiple  clients  using 
different  input  data  can  invoke  a  single  stored  procedure. 

•  Stored  procedures  are  much  faster  in  Client/Server  systems,  which  will  be 
explained,  in  Chapter  IV. 
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The  problem  with  stored  procedures  is  that  they  are  vendor-specific,  totally  non¬ 
standard,  not  portable  across  platforms,  and  have  no  standard  interface  definition 
language  or  stub  compiler.  Therefore,  there  is  no  standard  way  to  pass  or  define 
parameters. 

Another  alternative  to  Embedded  SQL  is  to  use  a  callable  SQL  Application 
Programming  Interface  (API)  for  database  access.  An  API  does  not  require  a 
precompiler  to  convert  SQL  statements  into  a  high-level  language,  which  can  then  be 
compiled  and  executed  on  the  database.  Instead,  an  API  allows  the  user  to  create  and 
execute  SQL  statements  at  run  time.  A  standard  API  can  be  used  to  produce  portable 
applications  that  are  independent  of  any  database  product.  The  SQL  Access  Group  Call 
Level  Interface  (SAG  CLI)  specifies  a  common  API  for  accessing  multiple  databases.  It 
provides  common  SQL  semantics  and  syntax,  codifies  the  SQL  data  types,  and  provides 
common  error  handling  and  reporting  [Ref:  3].  The  SAG  API  enables  the  client  to 
connect  to  a  database,  execute  requests,  retrieve  the  results  and  terminate  the  connection. 
Table  3.2  provides  a  comparison  of  the  features  of  CLI  and  Embedded  SQL. 


Features 

X/OpenSQL 
Call-Level  Interface 

ISO  SQL-92 
Embedded  SQL(ESQL) 

Requires  target  database  to 
be  toown  ahead  of  time 

No 

Yes 

Supports  Static  SQL 

No 

Yes 

Supports  dynamic  SQL 

Yes 

Yes 

Supports  stored  procedures 

No 

No 

Applications  must  be 
precompiled  and  bound  to 
database  server 

No 

Yes 

Easy  to  program  and  debug 

No 

Yes 

Tool  fiiendly 

Yes 

No 

Easy  to  package 

Yes 

No 

Table  3.2:  Comparison  of  CLI  and  Embedded  SQL  features  [Ref:  4] 


Microsoft’s  ODBC  is  a  Windows  API  that  is  an  extended  version  of  the  SAG 
CLI.  In  addition  to  its  basic  functionality,  it  provides  methods  to  retrieve  information 
about  the  database  and  handle  multimedia  types  of  data.  ODBC  offers  the  ability  to 
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connect  to  multiple  kinds  of  databases  on  different  platforms.  However,  the  following 
are  its  drawbacks: 

•  It  is  procedure  oriented  and  thus  does  not  mold  with  most  of  the  application 
programs  written  in  an  object-oriented  language. 

•  ODBC  standards  are  controlled  by  one  vendor  and  are  subject  to  change  at  the 
vendor’s  wish. 

•  ODBC  is  hard  to  learn  and  debug.  It  mixes  simple  and  advanced  features 
together. 

•  ODBC  driver  manager  and  drivers  must  be  installed  on  every  client  machine. 
This  means  it  would  be  a  poor  choice  for  a  web-based  database  system. 

•  It  has  drawbacks  in  the  security,  robustness  and  portability  of  applications 
[Ref:  5]. 

Because  of  these  drawbacks,  and  since  Java  is  the  natural  language  of  choice  for 
an  Internet  based  database  system,  JDBC  was  developed  by  Srm  Microsystems  as  a  high- 
level  API  for  invoking  SQL  commands  directly  on  different  vendor  databases.  JDBC 
provides  the  security,  robustness  and  portability  that  ODBC  lacks.  JDBC  is  a  Java  API 
that  enables  large-scale  applications  to  provide  “pure  Java”  solutions.  We  will  introduce 
and  explain  the  JDBC  API  in  Chapter  V. 

Three  standard  types  of  database  architecture  models  have  been  developed  based 
on  the  physical  distribution  of  components  in  a  DBMS.  In  the  first  model  all  components 
that  enable  the  user  to  operate  and  maintain  the  data  are  located  on  a  single  machine. 
This  is  typically  referred  to  as  a  “Stand-Alone”  DBMS.  The  drawback  of  this  approach  is 
that  it  doesn’t  allow  sharing  of  the  database  between  multiple  users.  The  first  generation 
of  Enterprise  Information  Systems  were  maintained  on  a  single  mainfirame  computer 
utilizing  this  model. 

Advances  in  computer  communications  and  networking  led  to  the  second 
generation  of  Database  Architecture  Models,  which  had  the  ability  to  integrate  different 
flavors  of  locally  maintained  databases  into  one  large  distributed  DBMS.  In  this  system  a 
search  request  generated  by  a  user  is  distributed  to  multiple  databases  and  the  results  are 
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returned  more  rapidly.  The  drawbacks  of  these  systems  are  the  maintenance  overhead, 
cost  and  performance.  [Ref:  1] 

The  latest  generation  of  Database  Architecture  Models  is  referred  to  as  the 
Client/Server  model.  It  comprises  the  positive  aspects  of  both  the  stand-alone  and 
Distributed  Database  Architecture  Models.  In  a  Client/Server  architecture  model  the  data 
processing  is  divided  between  the  client  and  the  database  server,  which  are  connected  by 
a  commimications  network.  This  model  is  the  focus  of  our  thesis  and  will  be  further 
discussed  in  Chapter  IV. 
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IV.  CLIENT/SERVER  ARCHITECTURE 


The  term  Client/Server  is  an  application  architecture  that  enables  a  computerized 
application  to  be  broken  up  into  two  or  more  less  complex  tasks  with  a  commimication 
mechanism  for  these  sub-processes  to  cooperate  [Ref:  5]. 

Typical  examples  of  application  layers  are: 

•  Presentation  Logic:  Handling  how  the  user  interacts  with  the  application. 
Usually  implemented  by  providing  an  easy  to  use  Graphical  User  Interface 
(GUI). 

•  Business  Logic:  Handling  the  business  rules  of  the  application. 

•  Data  Access  Logic:  Handling  the  storage  and  retrieval  of  data. 

The  forms  of  Client/Server  systems  in  use  today  are  one-tiered,  two-tiered,  three¬ 
tiered  and  N-tiered  architectures.  All  of  these  Client/Server  systems  have  the  following 
distinguishable  properties  [Ref  6]: 

•  Service:  Client/Server  is  primarily  a  relationship  between  processes  running 
on  separate  machines.  The  server  process  is  a  provider  of  services.  The  client 
is  a  consumer  of  services.  In  essence,  Client/Server  provides  a  clean 
separation  of  function  based  on  the  idea  of  service. 

•  Shared  resources:  A  server  can  service  multiple  clients  at  the  same  time  and 
regulate  their  access  to  shared  resources. 

•  Asymmetrical  protocols:  There  is  a  many-to-one  relationship  between  clients 
and  server.  Clients  always  initiate  the  dialog  by  requesting  a  service.  Servers 
are  passively  awaiting  requests  from  the  clients. 

•  Transparency  of  location:  The  server  is  a  process  that  can  reside  on  the  same 
machine  as  the  client  or  on  a  different  machine  across  a  network. 
Client/Server  software  usually  masks  the  location  of  the  server  from  the 
clients  by  redirecting  the  service  calls  when  required.  A  program  can  be  a 
client,  a  server,  or  both. 
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•  Mix-and-match:  The  ideal  Client/Server  software  is  independent  of  hardware 
or  operating  system  software  platforms.  You  should  be  able  to  mix-and- 
match  client  and  server  platforms. 

•  Message-based  exchanges:  Clients  and  servers  are  loosely  coupled  systems 
that  interact  through  a  message-passing  mechanism.  The  message  is  the 
delivery  mechanism  for  a  service  request  and  reply. 

•  Encapsulation  of  services:  The  server  is  a  “specialist.”  A  message  tells  a 
server  what  service  is  requested;  it  is  then  up  to  the  server  to  determine  how  to 
get  the  job  done.  Servers  can  be  upgraded  without  affecting  the  clients  as 
long  as  the  published  message  interface  is  not  changed. 

•  Scalability.  Client/Server  systems  can  be  scaled  horizontally  or  vertically. 
Horizontal  scaling  entails  adding  or  removing  client  workstations  with  only  a 
slight  performance  impact.  Vertical  scaling  entails  migrating  to  a  larger  and 
faster  server  machine  or  multiservers. 

•  Integrity:  Server  code  and  server  data  is  centrally  maintained,  which  results 
in  cheaper  maintenance  and  the  guarding  of  shared  data  integrity.  At  the  same 
time,  the  client  remains  personal  and  independent. 

The  Client/Server  properties  identified  above  describe  how  data  can  easily  be 
accessed  across  a  network.  They  also  provide  a  template  for  Client/Server  design 
architecture. 

The  creation  of  Enterprise  Information  Systems  grew  from  the  problems 
associated  with  monolithic  mainframe  systems.  Each  of  these  systems  contained  their 
own  presentation  object,  business  logic  and  access  mechanisms.  They  could  not  share 
data  with  other  systems,  so  each  had  to  store  a  private  local  copy.  This  resulted  in 
redundant  copies  in  an  organization.  The  inefficiency  and  cost  of  these  systems  led  to 
Relational  database  technology  and  Client/Server  systems  that  use  more  than  one  tier. 
This  was  made  possible  by  new  technologies  like  networks,  low-cost  personal  computers 
and  RDBMSs. 
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First  generation  Client/Server  systems  were  created  using  a  two-tiered 
architecture,  where  a  client  presents  a  GUI  to  the  user,  and  utilizes  the  user’s  data  entry 
and  actions  to  perform  requests  of  a  database  server  running  on  a  different  machine. 
Application  logic  is  tied  to  the  client  application  and  a  network  process  is  required  to 
mediate  the  Client/Server  interaction.  These  systems  can  be  implemented  quickly  using 
rapid  application  development  tools. 

The  problems  associated  with  placing  the  application  logic  with  the  client  are  the 
requirement  for  processing  power  and  fast  network  connections  to  handle  large  result  sets 
that  may  be  returned  in  response  to  database  requests.  If  the  logic  changes,  the  effort  in 
updating  software  on  numerous  workstations  can  be  excessive  and  lead  to  high  costs  in 
maintenance  and  support. 

An  alternative  implementation  is  to  colocate  the  application  logic  on  the  host  with 
the  database  using  stored  procedures.  This  does  not  solve  all  of  the  problems.  The  need 
for  the  database  to  maintain  a  separate  session  for  each  client  will  result  in  the  rapid 
consumption  of  back-end  server  resources. 


Figure  4.1:  Two-Tiered  Client/Server  model  [Ref:  5] 

Both  of  these  implementations  reduce  the  possibility  for  flexibility  and  portability 
due  to  the  proprietary  nature  of  the  underlying  models.  In  general,  two-tiered  systems  do 
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not  provide  the  scalability  for  large-scale  applications  deployed  across  a  network  or  the 
Internet.  Figure  4.1  presents  the  two-tiered  Client/Server  model. 

The  three-tier  Client/Server  architecture  extends  the  basic  two-tier  Client/Server 
model  by  adding  a  middle  tier  to  support  the  application  logic  and  common  services.  The 
client  interacts  with  the  middle  tier  via  a  standard  protocol  such  as  TCP/IP.  The  middle 
tier  interacts  with  the  server  via  appropriate  database  protocols.  In  addition,  the  middle 
tier  contains  most  of  the  application  logic,  translating  client  calls  into  database  queries 
and  translating  the  results  returned  from  the  database  into  a  client  viewable  format. 
Figure  4.2  describes  the  three-tier  Client/Server  model. 


Figure  4.2:  Three-Tier  Client/Server  model  [Ref:  5] 


By  creating  three  tiers,  the  application  can  be  partitioned  into  the  presentation 
logic,  business  logic  and  data  access  logic.  The  advantage  is  that  any  of  the  tiers  can  be 
enhanced  or  replaced  without  affecting  other  tiers.  This  approach  does  not  require  a 
separate  database  connection  for  each  user,  instead  many  user  sessions  can  be  funneled 
into  a  few  database  connections  enabling  savings  of  system  resources,  such  as  processing 
and  memory  on  the  database  server.  While  two-tier  systems  remain  suited  for  simple 
applications,  three-tier  Client/Server  solutions  are  recognized  as  the  ideal  choice,  since 
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they  are  more  maintainable  and  supportable,  and  are  flexible  to  adapt  to  ever-changing 
requirements. 

The  three-tier  architecture  can  be  extended  to  N-tiers  when  the  middle  tier 
provides  connections  to  various  types  of  services,  integrating  and  coupling  them  to  the 
client,  and  to  each  other.  An  N-tiered  system  can  also  be  created  by  partitioning  the 
application  logic  among  various  hosts.  As  requirements  change,  the  partitioning  and 
deployment  of  the  system  can  be  reviewed  and  modified  with  minimal  impact.  CORBA 
gives  you  the  capability  to  implement  an  N-tiered  architecture  due  to  its  flexibility.  This 
implementation  remains  largely  theoretical  in  nature,  as  most  organizations  operating  in  a 
Client/Server  environment  are  currently  utilizing  a  three-tier  architecture.  Figure  4.3 
describes  the  N-tier  Client/Server  model. 


A.  COMPONENT  BASED  THREE-TIER  CLIENT/SERVER  SYSTEMS 

A  component  is  an  application  independent  object  that  represents  a  real  world 
entity.  Components  can  be  used  in  multiple  applications  without  any  modification. 
Components  contain  a  user  interface,  maintain  their  state  and  can  cooperate  with  other 
components.  Component-based  architectures  are  considered  the  ideal  technology  for 
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three-tier  Client/Server  systems.  The  main  reason  is  due  to  their  ease  of  expandability. 
In  our  EIS  prototype,  the  components  that  make  up  the  first  tier  present  a  view  of  the 
application  to  the  user.  The  middle  tier  components  enforce  the  business  logic.  The 
server  components  have  access  to  the  back-end  information  source  and  contain  the  data 
access  logic.  Any  of  the  components  in  the  system  can  be  modified  or  replaced  without 
redesigning  the  entire  application.  Clients  interact  only  with  the  front-end  components. 
Front-end  components  communicate  with  middle  tier  components,  which  in  turn  interact 
with  back-end  components  to  execute  any  operation  requested  by  the  client.  We  will 
cover  all  of  these  components  beginning  with  the  back-end  components,  which  are 
responsible  for  accessing  the  database.  These  components  use  JDBC  to  insert,  modify 
and  retrieve  data  from  the  database  server.  In  order  to  understand  these  components,  the 
reader  needs  to  be  familiar  with  Java  and  the  JDBC  package  in  particular.  Chapter  V  will 
cover  the  essential  information  regarding  Java  and  JDBC  and  how  they  can  be  used  to 
implement  a  Client/Server  system. 
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V.  JAVA  AND  JDBC 


A.  JAVA 

Java  is  an  object-oriented  programming  language  that  can  be  used  to  create 
applets,  which  are  programs  that  can  be  embedded  in  a  web  page.  Instead  of  web  pages 
with  text  and  static  graphics,  Java  applets  can  make  use  of  audio,  animation,  interactivity 
and  video  imaging. 

One  of  the  biggest  advantages  of  Java  is  that  it  is  portable.  Therefore,  an 
application  written  in  Java  is  platform  independent.  Any  computer  with  a  Java-capable 
browser  can  run  Java  applets.  Developers  don’t  need  to  modify  applets  or  stand-alone 
applications  code  when  changing  platforms.  Additionally,  most  organizations  retain 
existing  legacy  code  that  they  do  not  wish  to  convert  to  Java.  Because  Java  was  created 
with  the  capability  to  interface  to  existing  C  and  C-H-  code,  this  provides  a  workable 
solution  to  a  problem  most  organizations  face. 

With  other  programming  languages  the  compiler  creates  platform  specific 
machine  language  code.  In  comparison,  the  Java  compiler  creates  Java  byte-code,  which 
in  turn  is  interpreted  by  the  Java  Virtual  Machine  (JVM)  at  run-time.  Therefore,  an 
application  can  be  run  on  any  platform  for  which  a  Java  Virtual  Machine  Implementation 
exists. 

The  Java  programming  language  was  designed  firom  the  start  as  an  object-oriented 
programming  language.  Object-oriented  languages  enable  designers  to  break  up  large 
projects  into  easily  manageable  components.  These  components  can  be  modified  and  re¬ 
used  -with  considerably  less  effort  than  monolithic  applications. 

Java  is  a  natural  language  for  writing  applications  for  distributed  systems  because 
of  the  following: 

•  Garbage  collection:  with  other  programming  languages  a  significant  burden 
on  the  programmer  is  the  allocation  and  de-allocation  of  memory.  Memory 
leaks  in  a  program  can  cause  an  application  to  crash.  In  Java,  if  an  object  is 
no  longer  being  used,  it  is  automatically  removed  firom  memory  by  the  Java 
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garbage  collector.  C++  for  instance  requires  that  the  programmer  keep  track 
of  the  allocation  and  deallocation  of  memory,  which  is  not  a  concern  in  Java. 

•  No  Pointers:  this  feature  removes  a  significant  source  of  errors  in  computer 
programming.  Java  utilizes  “object  references”  instead  of  memory  pointers. 
This  eliminates  problems  concerning  pointer  arithmetic  and  “out  of  bounds” 
memory  access  errors. 

•  Multi-threaded:  the  ability  of  a  program  to  do  more  than  one  thing  at  a  time. 
This  is  important  in  multi-media  and  network  applications,  due  to  the  CPU 
intensive  nature  of  these  applications  and  the  inherently  slow  speed  of 
network  connections. 

•  Strong  Typing:  Java  enforces  strong  type  checking,  therefore  many  errors  are 
caught  at  compile  time.  This  significantly  cuts  down  on  run-time  errors. 

•  Scalability:  the  Java  platform  is  designed  to  scale  well.  The  small  footprint  of 
the  JVM  and  its  optimized  byte-code  enable  Java-based  applications  to  run  on 
a  wide  range  of  platforms,  from  smart-cards  with  limited  processing 
capabilities  to  mainframes. 

•  Security:  the  JVM  is  designed  with  security  in  mind  and  automatically 
subjects  all  programs  to  byte-code  verification.  The  byte-code  verifier  checks 
that  the  format  of  incoming  code  is  correct,  meaning  that  it  doesn’t  forge 
pointers,  doesn’t  violate  access  restrictions  and  uses  objects  only  for  what  they 
were  intended. 

Java  programs  go  through  five  phases  in  order  to  be  executed.  These  are  edit, 
compile,  load,  bytecode  verify,  and  execute.  Figure  5.1  describes  the  specifics  of  a  Java 
development  environment. 
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Figure  5.1:  Typical  Java  environment  [Ref:  8] 


•  Editor  -  the  program  is  created  and  stored  on  disk. 

•  Compiler  -  creates  the  bytecode  and  stores  it  on  disk. 

•  Class  Loader  -  places  bytecode  into  memory. 

•  Bytecode  Verifier  -  confirms  that  all  bytecode  is  valid  and  doesn’t  violate 
Java’s  security  restrictions. 

•  Interpreter  -  reads  bytecode  and  translates  it  into  a  language  that  the 
computer  can  understand,  possibly  storing  data  values  as  the  program 
executes. 

B.  JDBC 

JDBC  is  a  high  level  Application  Programming  Interface  (API).  Developers  use 
the  JDBC  API  classes  and  interfaces  to  make  necessary  transactions  with  a  RDBMS, 
while  JDBC  driver  vendors  use  JDBC  to  model  their  drivers  accordingly.  JDBC  consists 
of  a  set  of  classes  and  interfaces  written  in  the  Java  programming  language  and  provides 
a  standard  API  for  database  developers,  making  it  possible  to  write  database  applications 
using  a  pure  Java  API. 
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With  the  JDBC  API,  programs  written  to  access  a  database  do  not  require 
extensive  modification  when  the  backend  database  has  been  changed.  A  program  written 
with  the  JDBC  API  can  send  SQL  statements  to  multiple  database  architectures 
simultaneously.  This  enables  organizations  to  continue  to  use  legacy  database 
management  systems,  as  well  as,  modem  Client/Server  systems. 

Development  time  for  new  applications  is  short  and  installation  and  version 
controls  are  greatly  simplified.  A  programmer  can  write  an  application  or  an  update 
once,  place  it  on  the  server,  and  everybody  has  access  to  the  latest  version. 

JDBC  makes  it  possible  to  easily  perform  the  following  tasks: 

•  Establish  a  connection  with  a  database. 

•  Send  SQL  statements. 

•  Process  the  results. 

The  following  describes  each  JDBC  capability  in  detail: 

1.  Establishing  a  connection  with  the  database: 

This  involves  two  steps:  loading  a  JDBC  driver  and  making  a  connection. 
Loading  the  driver  is  accomplished  by  asking  for  an  instance  of  the  driver  explicitly,  as  in 
the  folio-wing  line: 

Class . forName  ("sun. jdbc.odbc. JdbcOdbcDriver") ; 

A  coimection  is  established  by  using  the  appropriate  driver  to  connect  to  the 
DBMS.  The  corresponding  sub-protocol  identifier  is  appended  after  the  keyword  jdbc:. 
The  following  code  explains  how  this  is  accomplished: 

string  url="jdbc:  f f-microsof t :  //cryptologist . cs .nps .navy .mil"  ; 

String  login  =  "sa"; 

String  password  =  "test"; 

Connection  con  =  DriverManager .getConnection 
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(url,  login,  password) ; 


2.  Sending  SQL  statements: 

In  order  to  execute  a  SQL  statement  on  a  relational  database  using  JDBC,  a 
statement  object  must  be  created.  The  SQL  statement  to  be  executed  is  supplied  as  an 
argument  to  the  proper  method  of  the  statement  object.  The  type  of  method  differs 
according  to  the  query  being  executed.  The  following  code  shows  how  to  create  a 
statement  object  and  execute  a  simple  UPDATE  query: 

string  query  =  "UPDATE  SAILORS  "  + 

"SET  PHONE_NUMBER  =  555-2111  "  + 

"WHERE  LAST_NAME  =  Lewis  " ; 

Statement  stmt  =  con. createStatement  (); 

stmt . executeUpdate (query) ; 

.3.  Processing  the  results: 

When  a  SELECT  statement  is  executed,  the  results  of  the  query  will  be  returned 
in  a  ResultSet  object  defined  in  the  JDBC  package.  The  tuples  in  the  ResultSet  can  be 
retrieved  using  the  nextQ  method  defined  in  the  ResultSet  class.  The  following  code 
shows  how  to  create  and  execute  a  SELECT  statement,  retrieve  the  results  and  display 
the  tuples  in  the  ResultSet  object  to  the  screen. 

string  query  =  "SELECT  COiyiMAND_NAME  FROM  "  + 

"COMMAND_INFORMATION  "  + 

"WHERE  COMMAND_ID  =  93162"; 

ResultSet  rs  =  stmt . executeQuery (query) ; 

While  (rs.nextO)  { 

String  s  =  rs.getStringC'COMMAND^NAME"); 

System. out .print In  ("The  name  of  the  command  is:  ”  +  s) ; 

} 
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C.  JDBC  INTERFACES 


The  JDBC  API  consists  of  six  classes  and  eight  interfaces.  A  complete 
representation  of  these  classes  and  interfaces  is  shown  in  Figure  5.2.  Arrows  denote 
inheritance. 


Figure  5.2:  Diagram  of  all  JDBC  interfaces  and  classes  [Ref:  9] 


These  classes  and  interfaces  represent  database  coimections,  SQL  statements, 
result  sets  and  database  metadata.  The  most  important  classes  and  interfaces  will  be 
discussed  in  the  following  sections. 
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1.  DriverManager: 


The  DriverManager  keeps  track  of  available  drivers  and  handles  the  creation  of 
connections  between  databases  and  appropriate  drivers.  By  invoking  the  getConnectionQ 
method  on  this  interface,  a  valid  connection  with  the  database  can  be  established. 

2.  Connection  Interface: 

A  connection  represents  a  session  with  a  specific  database.  Within  the  context  of 
a  connection,  SQL  statements  are  executed  and  results  are  returned  [Ref:  10].  An 
application  can  have  one  or  more  connections  with  a  single  database  or  it  can  have 
simultaneous  connections  with  multiple  databases.  The  established  connection  passes 
SQL  statements  to  the  connected  database. 

3.  Statement  Interface: 

SQL  statements  without  parameters  are  normally  executed  using  this  object.  The 
Statement  object  can  be  created  by  calling  the  createStatement()  method  of  a  connection 
object.  The  execute  method  can  be  invoked  to  execute  SQL  statements: 

boolean  execute (String  arg)  throws  SQLException; 

This  method  executes  arg,  which  is  a  SQL  statement  that  may  return  one  or  more 
result  sets,  one  or  more  update  coimts,  or  any  combination  of  these.  This  method  is 
useful  if  the  designer  doesn’t  know  whether  the  statement  will  be  an  update  or  a  query 
operation.  A  call  to  this  method  executes  a  SQL  statement  and  returns  true  if  the  result  is 
a  ResultSet  and  returns  false  if  the  result  is  an  update  count. 

ResultSet  executeQuery (string  arg)  throws  SQLException; 

This  method  executes  arg,  which  is  a  SQL  statement  that  returns  a  single  result  set 
representing  the  results  of  the  provided  query. 

int  executeUpdate (String  arg)  throws  SQLException; 
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This  method  executes  a  SQL  INSERT,  UPDATE,  or  DELETE  statement  that 
doesn’t  have  parameter  placeholders.  It  may  also  be  used  to  execute  SQL  statements 
which  return  no  value,  such  as  CREATE  TABLE  or  DROP  TABLE. 


4.  PreparedStatement  Interface: 

If  the  same  SQL  statement  is  executed  many  times,  it  is  more  efficient  to  use  a 
PreparedStatement.  A  SQL  statement  with  or  without  IN  parameters  can  be  pre¬ 
compiled  and  stored  in  a  PreparedStatement  object.  A  PreparedStatement  object  can  be 
more  efficient  than  a  Statement  object,  because  it  has  been  pre-compiled  and  stored  by 
the  database.  In  order  to  benefit  from  pre-compilation,  the  JDBC  driver  must  support  this 
feature.  The  PreparedStatement  object  can  be  created  by  calling  the  prepareStatementQ 
method  of  a  connection  object. 

5.  CallableStatement  Interface: 

A  CallableStatement  is  used  to  execute  SQL  stored  procedures.  These  stored 
procedures  are  SQL  statements  that  can  be  invoked  by  a  name.  Various 
DatabaseMetaData  methods  can  be  used  to  retrieve  information  regarding  which  stored 
procedures  a  DBMS  supports  and  the  descriptions  and  names  of  these  procedures. 
CallableStatement  objects  are  created  vdth  the  coruiection  method  prepareCall  (). 

6.  ResultSet  Interface: 

A  ResultSet  object  provides  access  to  a  table  of  data  generated  by  executing  a 
SQL  statement.  Table  rows  are  retrieved  in  sequence.  Within  a  row  column  values  can 
be  accessed  in  any  order  [Ref:  4].  A  ResultSet  maintains  a  cursor  pointing  to  its  current 
row  of  data.  In  order  to  retrieve  the  first  line  of  data,  the  nextQ  method  must  be  invoked. 
Various  getXXXQ  methods  can  be  invoked  to  retrieve  different  column  values.  The  SQL 
data  types,  the  corresponding  Java  data  types,  and  the  recommended  method  calls  for 
conversion  are  shown  in  Table  5.1. 
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SQL  Data  Type 

JAVA  data  type 

Recommended  getXXX 
Conversion  method 

CHAR 

String 

getStringO 

VARCHAR 

String 

getStringO 

LONGVARCHAR 

String 

get  Ascii  StreamO 
getUnicodeStreamQ 

NUMERIC 

j  ava.math.BigDecimal 

getBigDecimalQ 

DECIMAL 

j  ava.math.BigDecimal 

getBigDecimalO 

BIT 

boolean 

getBooleanQ 

TINYINT 

byte 

getByteO 

SMALLINT 

short 

getShortQ 

INTEGER 

int 

getIntO 

BIGINT 

long 

getLongO 

REAL 

float 

getFloatQ 

DOUBLE 

double 

getDoubleQ 

FLOAT 

double 

getDoubleQ 

BINARY 

byte[] 

getBytesQ 

VARBINARY 

byten 

getBytesQ 

LONGVARBINARY 

byte[] 

getBinaryStreamQ 

DATE 

java.sql.Date 

getDateO 

TIME 

java.sql.Time 

getTimeQ 

TIMESTAMP 

java.sql.Timestamp 

getTimestampO 

Table  5.1:  SQL  and  Java  data  types  and  recommended  conversion  methods 


D.  JDBC  AND  CLIENT/SERVER  MODELS 


The  JDBC  API  supports  database  access,  utilizing  two-tier  and  three-tier  models. 
In  the  two-tier  model,  a  Java  applet  or  application  communicates  with  the  database.  This, 
requires  a  JDBC  driver  that  can  communicate  with  the  particular  DBMS  being  accessed. 
A  user’s  SQL  statement  is  delivered  to  the  database  and  the  results  of  the  statement  are 
returned  to  die  user.  The  database  may  be  located  on  remote  machine  to  which  the  user  is 
coimected  via  a  network.  This  is  referred  to  as  a  Client/Server  configuration,  with  the 
user’s  machine  as  the  client,  and  the  machine  hosting  the  database  as  the  server.  The 
network  in  question  can  be  an  Intranet  or  an  Internet.  Since  all  code  is  executed  on  the 
client,  this  implementation  may  not  scale  very  well.  An  application  that  requires  multiple 
concurrent  client  connections  to  a  database  will  likely  be  a  huge  burden  for  both  the 
network  and  the  DBMS.  A  two-tier  driver  may  also  be  unable  to  take  advantage  of  the 

multi-threading  capabilities  of  Java,  if  the  client  libraries  themselves  are  not  multi- 
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threaded.  Threads  are  an  important  means  for  increasing  performance  because  they  allow 
multiple  concurrent  transactions  on  database  data.  Java  has  built-in  multi-threading 
support,  as  well  as  ways  to  synchronize  multi-threaded  operations,  but  if  the  client 
libraries  are  not  thread-safe,  the  JDBC  driver  cannot  take  advantage  of  this  capability. 

Most  Java  virtual  machines  restrict  applets  from  connecting  to  any  machines  other 
than  the  host  that  served  the  applet.  The  applet  therefore  cannot  connect  directly  to  any 
local  or  third-machine  databases.  Because  of  this  restriction  in  a  two-tier  architecture, 
the  applet  realizing  the  user  interface  must  be  stored  on  the  same  server  where  the 
database  is  stored.  Figure  5.3  describes  the  two-tier  model  using  JDBC. 


In  the  three-tier  model,  commands  are  sent  to  a  middle  tier  of  services,  which  then 
send  SQL  statements  to  the  database.  The  database  processes  the  SQL  statements  and 
sends  the  results  back  to  the  middle  tier,  which  then  passes  them  to  the  user.  This  makes 
the  three-tier  model  very  attractive,  because  the  middle  tier  makes  it  possible  to  maintain 
control  over  access  and  the  type  of  updates  that  can  be  made  to  archived  data.  Another 
advantage  is  that  when  there  is  a  middle  tier,  the  user  can  employ  an  easy-to-use  higher- 
level  API,  which  is  translated  by  the  middle  tier  into  appropriate  low-level  calls.  The 
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client  can  operate  as  a  multi-threaded  application  and  let  the  intermediate  server  handle 
the  synchronization.  In  a  three-tier  architecture  the  middle  layer  can  hide  information 
about  the  database  server  from  the  applet.  Only  the  middle  tier  know^s  how  to  find  and 
manipulate  the  data.  The  secure  intermediate  server  can  provide  the  means  to  shield  the 
client  from  direct  access  to  DBMS  by  providing  a  username  and  password  because  the 
identification  and  authentication  is  accomplished  at  the  server  level.  Figure  5.4  describes 
the  three-tier  model  using  JDBC. 


Java  Applet  or 
HTML  browser 

Client  Machine  (GUI) 

3 

_ J 

HTTP,  RMI,  CORBA,  or  other  calls 

f 

Application  Server 
(Java) 

Server  machine 
(business  logic) 

JDBC 

4 

< 

DBMS-proprietary  protocol 

.  ..•  -y 

'  '  ''' 

Database  server 

Figure  5.4:  JDBC  Three-Tier  model  (Ref:  8] 


E.  JDBC  DRIVERS 

Drivers  are  Java  classes  that  implement  the  driver  interface.  The  DriverManager 
will  load  and  use  an  instance  of  the  driver  class  to  answer  connection  requests.  When  a 
driver  class  is  loaded,  it  should  create  an  instance  of  itself  and  register  with  the 
DriverManager.  The  driver  interface  provides  six  methods,  which  are  used  to  set  up  a 
connection  between  a  driver  and  a  database,  provide  information  about  the  driver,  or  get 
the  information  necessary  for  making  a  connection  to  a  database.  [Ref:  9] 
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There  are  various  choices  for  driver  implementations.  Figure  5.5  depicts  the 
JDBC  driver  implementation.  The  following  are  the  various  classes  of  JDBC  drivers 
available: 


1.  JDBC-ODBC  bridge  plus  ODBC  Driver: 

A  JDBC-ODBC  bridge  implemented  in  JDK  1.1  provides  JDBC  access  to 
databases  via  most  ODBC  drivers.  To  use  this  bridge,  ODBC  binary  code,  and  in  some 
cases  database  client  code,  must  be  loaded  on  each  client  machine.  This  kind  of  driver  is 
most  suitable  for  a  corporate  network  where  client  installations  are  not  a  major  problem, 
or  for  application  server  code  written  in  Java  for  a  three-tier  Client/Server 
implementation. 


JDBC-Net 

Driver 


♦ 

JDBC 

Middleware 

Protocol 


Java  Application 


JDBC 

API 


JDBC  Driver  Manager 


JDBC  Driver 
API 

JDBC 

implementation 

alternatives 


Proprietary  database  access  protocols 


Figure  5.5:  JDBC  driver  implementation  [Ref:  8] 
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2.  Native-API  partly-Java  Driver: 

This  type  of  driver  converts  JDBC  calls  on  the  client  API  to  a  vendor  specific 
query  language  and  communication  protocol  for  use  on  a  DBMS.  Like  the  bridge  driver, 
some  binary  code  must  be  loaded  on  each  client  machine. 

3.  JDBC-Net  pure  Java  Driver: 

This  driver  translates  a  JDBC  call  into  a  DBMS  independent  net  protocol,  which 
is  then  translated  to  a  DBMS  protocol  by  a  server.  This  net  server  middleware  is  able  to 
connect  all  Java  clients  to  multiple  databases.  The  specific  protocol  used  depends  on  the 
vendor.  This  type  of  implementation  simplifies  administration  by  loading  all  DBMS 
drivers  on  the  middle  tier  application  server.  Of  all  driver  implementations,  this  is  the 
most  flexible. 

4.  Native-protocol  pure  Java  Driver: 

This  type  of  driver  converts  JDBC  calls  into  the  network  protocol  used  by  the 
DBMS’s  directly.  This  allows  a  direct  call  from  the  client  machine  to  the  DBMS  server 
and  is  a  practical  solution  for  Internet  access.  Since  many  of  these  protocols  are 
proprietary  in  nature,  the  driver  can  only  interface  with  vendor  specific  databases.  The 
most  sigmficant  advantage  of  this  driver  is  its  speed,  where  the  biggest  disadvantage  is 
the  loss  of  flexibility. 

F.  JDBC  SUMMARY 

JDBC  is  a  high-level  interface  that  is  used  to  execute  SQL  commands.  It  is  much 
easier  to  use  than  other  database  connectivity  API’s.  The  primary  problem  with  using 
JDBC  in  a  web-based  database  environment  is  the  requirement  to  install  JDBC  drivers  on 
each  client  machine  or  download  the  driver  for  every  connection.  With  slow  network 
connection  speeds,  clients  may  be  required  to  wait  while  the  driver  downloads.  Thus, 
there  would  be  a  significant  decrease  in  system  performance. 

In  our  implementation  we  are  using  JDBC  on  the  middle  tier  application  server, 
which  listens  for  CORBA  requests  and  then  uses  a  native-protocol  pure  Java  driver  to 
execute  the  corresponding  JDBC  methods  on  the  back-end  database.  This  is  the  three- 
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tier  JDBC  model.  ResultSets  are  parsed  and  packaged  as  CORBA  data  structures  to  be 
returned  to  the  client.  We  will  give  an  overview  of  CORBA  architecture  in  Chapter  VI 
and  provide  a  detailed  explanation  of  our  EIS  implementation  in  Chapter  VII. 
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VI.  COMMON  OBJECT  REQUEST  BROKER  ARCHITECTURE 

CORE  A  is  an  industry-wide  standard  for  creating  distributed  object  systems.  The 
Object  Management  Group  (OMG)  defines  CORBA.  OMG  is  a  non-profit  consortium  of 
over  800  companies.  The  goal  of  this  group  is  to  provide  definitions  of  standards  for 
interoperable  software  components.  CORBA  specifies  how  software  components 
distributed  over  a  network  can  work  together  to  perform  a  task  without  regard  to  the 
operating  systems  and  programming  languages  used.  OMG  only  facilitates  the 
definitions  of  these  standards;  it  does  not  deal  with  implementation  issues.  Software  that 
is  produced  in  accordance  -with  these  standards  will  be  interoperable  with  other  software 
that  follows  the  same  standards.  CORBA  also  specifies  an  extensive  set  of  services  for 
creating  and  deleting  objects,  accessing  them  by  name,  storing  them  in  persistent  stores, 
externalizing  their  states,  and  defining  ad-hoc  relationships  between  them.  [Ref:  3] 

CORBA  is  the  latest  evolution  of  Client/Server  computing.  Typical  Client/Server 
systems  partition  the  functionality  of  the  application,  such  that  the  client  applications 
perform  both  the  business  processing  and  user  interface.  The  server  is  used  as  the  back 
end  data  source  for  the  system,  usually  as  a  file  server  or  a  database  server.  Software 
maintenance  in  such  a  system  is  a  burden,  because  the  client  application  needs  to  be 
updated  with  every  change  of  the  application  or  business  logic.  Code  reuse  is  not  easy  to 
achieve,  because  the  rules  of  business  are  intermixed  with  presentation  and  data  storage 
logic.  These  problems  have  resulted  in  the  separation  of  Client/Server  systems  into  three 
specific  areas:  presentation,  business  logic  and  data  storage  and  retrieval.  The  tier  that 
encapsulates  the  business  and  application  logic  is  known  as  the  middle  tier. 
Implementations  of  the  middle  tier  have  become  known  as  the  middleware  [Ref:  3]. 
CORBA  is  superior  to  other  middleware  solutions  because  of  the  following  benefits  it 
offers: 


•  Open  standards’.  CORBA  is  based  on  open,  published  specifications.  It  is 
implemented  by  different  vendors  on  different  hardware  platforms  and  operating 
systems  using  various  programming  languages.  This  gives  the  user  maximum 
flexibility  in  choosing  and  upgrading  a  Client/Server  system. 
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•  Interoperability:  CORBA  objects  are  fiilly  interoperable  even  when  they  are 
developed  by  different  vendors  who  have  no  previous  knowledge  of  each  other's 
objects  because  they  communicate  using  a  common  protocol,  the  Internet  Inter- 
ORB  protocol. 

•  Modularity:  Every  CORBA-compIiant  object  has  a  well-defined  interface. 
CORBA  objects  communicate  with  each  other  using  these  interfaces.  Changing 
the  implementation  of  an  object  does  not  require  changes  in  other  objects  as  long 
as  the  interface  of  that  object  remains  the  same. 

•  Coexistence  with  legacy  systems:  CORBA  enables  organizations  to  protect 
their  investment.  A  legacy  application  can  be  encapsulated  in  a  CORBA  wrapper 
that  defines  an  interface  to  the  legacy  code.  This  interface  makes  the  application 
interoperable  with  other  objects  in  the  distributed  environment. 

•  Portability:  A  CORBA  object  written  on  one  platform  can  be  deployed  on  any 
other  platform  that  supports  CORBA. 

•  Security:  CORBA  provides  security  features  such  as  encryption,  identification 
and  authentication  of  the  entities  in  the  distributed  system  and  controls  access  to 
objects  and  their  published  services. 

A.  OBJECT  MANAGEMENT  ARCHITECTURE 

The  OMG  published  the  Object  Management  Architecture  Guide  (OMA  Guide) 
in  1990.  It  was  revised  in  1992  and  1995.  The  OMA  Guide  is  the  highest  level 
specification  that  covers  all  constituents  of  the  Common  Object  Request  Broker 
Architecture.  The  five  parts  of  the  architecture  are  provided  in  the  Figure  6.1. 
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Figure  6.1:  Object  management  architecture  [Ref:  10) 
a.  Object  Request  Broker(ORB): 

A  CORBA  Object  Request  Broker  is  the  middleware  that  handles 
interactions  between  objects.  A  client  machine  can  invoke  a  method  on  a  server  object 
that  can  be  on  the  same  machine  or  across  a  network  using  the  ORB.  The  ORB  intercepts 
this  call  and  locates  the  object  that  is  offering  the  services,  providing  supplied  parameters 
to  methods  and  returning  results  to  the  caller.  The  calling  object  does  not  need  to  know 
the  server  object’s  location,  the  programming  language  the  server  was  written  in  or  the 
operating  system  it  is  running  on.  The  ORB  separates  the  client  and  the  server  from  the 
underlying  communication  infrastructure  and  the  protocol  stack.  The  protocol  stack  is 
replaceable  as  migration  occurs  from  one  implementation  of  CORBA  to  another.  This 
provides  flexibility  for  application  architectures  and  simplifies  the  distributed  computing 
model  [Ref:  11].  The  client  and  server  roles  are  dynamic,  so  an  object  can  act  as  a  client 
to  a  published  service  of  another  object  in  one  occasion  and  can  itself  offer  services  in 
another  occasion.  Figure  6.2  shows  the  client  and  server  interacting  through  the  ORB. 
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Figure  6.2:  The  structure  of  a  CORBA  2.0  ORB  [Ref:  3] 


If  we  consider  the  components  of  the  Object  Request  Broker,  the  first 
thing  that  we  need  to  realize  is  that  CORBA  provides  both  static  and  dynamic  interfaces 
to  the  client.  Static  interfaces  are  defined  at  compile-time  and  provide  a  robust  and 
efficient  way  to  publish  the  services  provided  by  an  object,  in  addition  they  provide  fast 
access  at  run-time.  Dynamic  interfaces  lack  this  robustness  and  speed,  but  enable  the 
client  to  discover  and  use  the  services  of  server  objects  at  run-time.  The  following  is  a 
brief  discussion  of  the  parts  that  make  up  the  ORB. 

•  Client  IDL  Stubs:  An  interface  for  an  object  consists  of  named  operations  and 
the  parameters  required  by  those  operations.  All  interfaces  in  CORBA  are 
defined  using  Interface  Definition  Language  (IDL).  Client  IDL  stubs  are 
generated  by  an  IDL  compiler  and  provide  static  interfaces  to  services  provided 
by  an  object.  A  client  must  have  a  stub  for  the  services  it  wants  to  use  on  the 
server.  The  stub  performs  the  job  of  packaging  parameters  into  a  message  format 
for  transfer  over  the  network.  This  is  referred  to  as  marshalling. 

•  Dynamic  Invocation:  This  interface  allows  clients  to  discover  and  invoke 
services  offered  by  an  object  at  run-time. 
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•  Interface  Repository:  IR  is  a  database  for  storing  persistent  references  to 
objects  that  are  registered  with  the  ORB.  The  IR  contains  enough  information 
for  the  ORB  to  locate  and  activate  implementations  that  correspond  to  an  entry  in 
this  database. 

•  The  ORB  Interface:  This  consists  of  services  that  might  be  used  by  an 
application  such  as  converting  an  object  to  a  string  representation. 

•  Object  Adapter:  This  is  a  logical  set  of  services  that  enable  the  ORB  and  the 
implementation  of  the  server  object  to  communicate  with  each  other. 

•  Static  Skeletons:  Static  skeletons  are  created  by  compiling  the  IDL  definition 
of  a  server  object  using  an  IDL  compiler  for  a  specific  language.  Each  service 
supported  by  a  server  has  a  corresponding  skeleton  that  handles  the  marshalling 
of  the  parameters. 

•  Dynamic  Skeleton  Invocation:  These  services  find  the  object  that  offers  the 
service  requested  by  a  client  by  inspecting  the  parameters  and  name  of  the 
method.  This  provides  maximum  flexibility  in  a  rapidly  changing  environment 
or  an  environment  with  different  ORB  implementations  that  have  no  previous 
knowledge  of  each  other. 

•  The  Implementation  Repository:  This  is  a  database  that  can  be  used  to  keep 
track  of  the  server  objects  and  the  services  they  offer. 

b.  CORBA  Services: 

CORBA  services  are  provided  for  the  application  developer  who  will 
provide  the  implementations  of  the  CORBA  objects.  CORBA  services  include  services 
to  store,  manage  and  locate  objects,  to  enforce  relationships  between  objects  and  provide 
the  infrastructure  for  building  licensing  and  security  services. 
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CORBA  SERVICES 

Naming  Service 

Queiy  Service 

Event  Service 

Licensing  Service 

Persistence  Service 

Security  Service 

Life  Cycle  Service 

Time  Service 

Concurrency  Control  Service 

Trader  Service 

Transaction  Service 

Collections  Service 

Relationship  Service 

Extemalization  Service 

Figure  6.3:  CORBA  Services  in  the  object  management  architecture. 


OMG  has  defined  a  set  of  common  CORBA  services  as  shotvn  in  Figure 
6.3.  The  following  is  a  list  of  some  of  the  more  important  services: 

•  Naming  Service:  The  naming  service  is  used  to  associate  a  human-readable 
name  with  a  CORBA  object  reference.  The  name  of  the  object  is  bound  to  the 
object  relative  to  a  naming  context.  In  a  naming  context  each  name  is  unique. 
Naming  service  enables  CORBA  to  find  another  object  by  resolving  the  provided 
name  in  a  naming  context. 

•  Event  Service:  This  service  allows  objects  to  register  and  unregister  their 
interest  in  specific  events.  A  common  bus  named  the  event  channel  is  used  to 
transfer  messages  from  the  generator  of  an  event  to  objects  that  have  expressed 
their  desire  to  receive  the  event. 

•  Persistent  Object  Service:  This  service  provides  a  set  of  common  interfaces 
for  storing  objects  in  persistent  storage.  The  storage  can  range  in  type  from  a 
text  file  to  a  Relational  or  Object  DBMS. 
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•  Life  Cycle  Service:  This  service  includes  operations  for  the  creation,  copying, 
moving  and  deletion  of  objects  from  the  ORB.  Factory  objects,  which  can  be 
used  to  create  CORBA  objects,  are  defined  in  this  service. 

•  Concurrency  Control  Service:  This  service  enables  multiple  clients  to 
coordinate  their  access  to  shared  resources.  This  is  achieved  by  placing  a  lock  on 
an  object  to  provide  atomic  access. 

•  Transaction  Service:  Distributed  applications  need  to  have  certain  properties 
to  fimction  properly.  The  four  vital  properties  are  atomicity,  consistency, 
isolation  and  durability.  This  service  is  used  for  the  enforcement  of  these 
properties  in  a  distributed  system  that  uses  CORBA  as  its  architecture. 

•  Relationships  Service:  This  is  a  general-purpose  service  for  establishing 
relationships  between  objects.  The  expression  of  a  relation  in  the  form  of  an 
object  makes  abstract  concepts  such  as  entities  and  relationships  explicitly 
representable  in  the  distributed  architecture.  One  of  the  relationship  types 
between  objects  for  example,  is  containment  relationship.  This  would  be 
represented  by  a  relationship  between  the  container  object  and  the  contained 
objects. 

•  Externalization  Service:  This  service  defines  protocols  and  conventions  for 
recording  the  state  of  an  object  in  a  stream  of  data  that  can  be  saved  to  a  file  or 
transported  across  the  network.  This  process  is  called  externalization.  The 
externalized  object  can  be  restored  by  reversing  the  process,  which  is  called 
internalization. 

•  Security  Service:  This  service  includes  features  that  can  be  used  to  provide  a 
framework  for  a  distributed  object  system.  The  issues  addressed  are  the 
identification  and  authentication  of  principals  in  the  system,  confidentiality  and 
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integrity  of  messages  sent  over  the  ORB,  ensuring  availability  of  resources, 
providing  access  control  to  objects  based  on  the  identity  and  privileges  of  the 
requesting  object  and  auditing  the  actions  of  a  principal. 

•  Trading  Service'.  The  functionality  of  this  service  is  similar  to  a  matchmaking 
service  for  objects  in  the  system.  An  object  that  provides  a  service  advertises 
itself  by  exporting  information  about  the  service  it  provides,  the  parameters  it 
expects  and  a  reference  to  itself  that  can  be  used  by  a  client  to  invoke  operations 
on  the  advertised  services. 

•  Licensing  Service:  Licensing  service  includes  interfaces  to  protect  the 
intellectual  property  of  developers.  Licensing  services  can  be  used  to  control 
software  licenses  in  a  distributed  system. 

•  Time  Service:  This  service  can  be  used  for  the  synchronization  of  different 
components. 

CORBA  services  are  primitive,  general  and  fundamental  building  blocks 
that  can  be  used  in  a  distributed  object  system.  They  are  useful  for  all  kinds  of 
applications  and  are  domain-independent  in  that  they  are  intended  to  be  reused  and 
specialized  by  applications  [Ref:  11].  An  application  developer  can  achieve  the 
functionality  desired  in  an  implementation  by  inheriting  from  multiple  corresponding 
services.  Not  all  CORBA  services  are  available  at  this  time,  but  all  ORB  vendors  provide 
a  subset  of  existing  CORBA  services. 

c.  CORBA  Facilities: 

CORBA  facilities  are  higher-level  services  that  aim  to  establish 
application-level  interoperability.  They  provide  Interface  Definition  Language  -  defined 
frameworks  that  are  of  use  to  application  objects.  The  interfaces  in  CORBA  facilities  are 
common  to  multiple  domains.  The  common  facilities  that  are  being  built  by  OMG 

members  include  facilities  to  handle  user  interface  management,  information 

48 


management,  systems  management  and  task  management.  CORBA  facilities  can  reuse 
services  provided  by  the  CORBA  services  or  they  can  inherit  and  extend  them.  Figure 
6.4  illustrates  the  relationship  between  CORBA  services,  CORBA  facilities  and  CORBA 
domains. 


Figure  6.4:  Reuse  of  OMG  specifications  [Ref:  11] 

d.  CORBA  Domains'. 

CORBA  domains  are  a  business-specific  standardization  that  considers  the 
interoperability  needs  of  specialization  areas  such  as  healthcare,  manufacturing  or 
telecommunications.  CORBA  domains  do  not  answer  the  common  needs  of  multiple 
domains.  This  should  be  handled  by  CORBA  facilities.  CORBA  domains  might  use  or 
inherit  from  the  services  provided  by  CORBA  facilities  or  CORBA  services  as  needed. 

e.  Application  Objects'. 

The  last  category  of  objects  in  the  CORBA  distributed  architecture  is  the 
application  objects  themselves.  These  objects  perform  specific  tasks  for  users.  They  can 
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use  or  inherit  from  the  standard  interfaces  provided  by  the  OMG,  including  CORBA 
services,  CORBA  facilities  and  CORBA  domains  or  they  can  provide  their  own 
interfaces.  Reuse  of  the  services  provided  by  the  OMG  enables  the  rapid  design  and 
employment  of  distributed  systems  and  conformity  to  standards. 

B.  INTERNET  INTER-ORB  PROTOCOL 

The  CORBA  2.0  specification  requires  ORB  vendors  to  implement  the  Internet 
Inter-ORB  (HOP)  protocol  or  to  provide  half-bridges  to  it.  The  goal  of  this  requirement 
is  to  ensure  communication  between  different  ORB  implementations.  HOP  makes  it 
possible  for  a  client  of  one  vendor’s  ORB  to  invoke  operations  transparently  on  an  object 
in  a  different  ORB.  The  General  Inter-ORB  protocol  (GIOP)  defines  a  set  of  message 
formats  and  common  data  representations  for  communication  between  different  ORBs. 
GIOP  is  designed  to  work  on  any  transport  protocol.  HOP  is  a  specialization  of  GIOP 
that  uses  TCP/IP  as  its  transport  layer. 

C.  INTERFACE  DEFINITION  LANGUAGE 

Interface  Definition  Language  (IDL)  is  a  standard  language  used  to  define 
interfaces  used  by  CORBA  objects.  IDL  is  a  part  of  the  CORBA  specification  and  is 
independent  of  any  programming  language.  Language  independence  gives  application 
developers  the  freedom  to  choose  the  language  they  want  to  use  in  the  distributed  object 
system.  Developers  can  pick  a  language  that  provides  better  performance,  or  one  in 
which  they  have  a  significant  investment.  They  can  even  use  different  languages  for 
different  parts  of  the  system.  It  is  also  possible  to  retain  and  use  legacy  applications  by 
creating  an  IDL  wrapper  for  them.  IDL  mappings  exist  for  a  number  of  languages 
including  C-H-,  Ada95  and  Java. 

IDL  is  a  declarative  language  that  is  syntactically  a  subset  of  the  ANSI  C-H- 
standard.  IDL  is  a  very  useful  tool  for  software  designers,  because  it  separates  the 
implementation  of  an  object  from  its  specification.  IDL  is  used  to  describe  an  object’s 
attributes,  the  services  that  it  provides,  the  classes  it  inherits  from,  the  exceptions  it  raises 
and  the  name  that  can  be  used  to  locate  the  implementation  in  a  distributed  architecture. 
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IDL  compilers  generate  client  stubs  and  server  skeletons  by  processing  an  IDL  file.  The 
structure  of  an  IDL  file  can  be  seen  in  Figure  6.5. 

module  < i dent i f ie r > 

{ 

<type  declarations>; 

<constant  declarations>; 

<exception  declarations>; 

interface  <identif ier>  [ : <inheritance>] 

{ 

<type  declarations>; 

<constant  declarations>; 

<attribute  declarations>; 

<exception  declarations >; 

[<op_type>] <identif ier> (<parameters>) 

[raises  exception [context] ; 


[<op__type>]  <identif  ier>  (<parameters>) 

[raises  exception] [context] ; 

}  ' 

interface  <identif ier>  [ : <inheritance>] 

} 

Figure  6.5:  The  structure  of  an  IDL  file  [Ref:  3] 

We  will  inspect  the  various  parts  that  make  up  the  IDL  file  in  the  following 
sections. 

a.  The  module: 

The  module  construct  in  an  IDL  file  is  used  to  group  together  IDL 
definitions  that  are  logically  related.  Modules  create  a  naming  scope  and  are  similar  in 
functionality  to  packages  that  can  be  found  in  various  programming  languages.  You  can 
use  the  same  name  for  two  different  interfaces  without  having  a  conflict  as  long  as  they 
are  in  different  modules.  The  following  example  shows  a  module  with  three  interfaces. 
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module  Bank{ 

interface  account {  ...  }  ; 
interface  accountFactory{  ...  }  ; 
interface  securityManager{  ...  }; 


The  fully  qualified  name  for  each  interface  would  be  Module:: Interface, 
for  example  Bank:: account. 


b.  Primitive  Data  Types'. 

CORBA  specifies  built-in  primitive  data  types  that  can  be  used  to 
represent  values.  Table  6.1  lists  the  primitive  data  types  supported  by  IDL. 


Type 

IDL  Identifier 

Description 

Float  point  type 

float 

IEEE  single-precision  floating  point  numbers 

Float  point  type 

double 

IEEE  double-precision  floating  point  numbers 

Integer  type 

long 

32  bits 

Integer  type 

short 

16  bits 

Integer  type 

unsigned  long 

32  bits 

Integer  type 

unsigned  short 

16  bits 

Char  type 

char 

8  bits 

Boolean  type 

boolean 

TRUE  or  FALSE 

Octet  type 

octet 

8-bits 

Any  type 

any 

An  arbitrary  IDL  type 

Table  6.1:  Basic  IDL  types  supported  in  IDL  [Ref:  12] 


c.  Constructed  Types'. 

Constructed  types  can  be  used  to  combine  primitive  data  types  to  define 
user-defined  types.  The  three  constructed  types  supported  by  IDL  are  enumerated  types, 
structures  and  unions. 
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•  Enumerated  Types:  Enumerated  types  allow  the  creation  of  types  that  can 
hold  one  value  of  a  pre-defmed  list  of  identifiers.  If  we  were  to  create  a  type  to 
represent  the  days  in  a  weekend,  we  could  create  an  enumerated  type  named 
weekenddays  in  the  following  way: 

enum  weekenddays  (Saturday,  Sunday)  ; 

•  Structures:  These  can  be  used  to  group  related  primitive  and  container  data 
types  as  a  single  logical  construct.  Container  types  will  be  explained  in  the  next 
section.  The  following  is  a  struct  that  represents  a  student  in  a  registration 
database: 

struct  student { 
string  name; 
string  lastName; 
short  studentNumber ; 
boolean  graduated; 

}; 


•  Unions:  Unions  can  be  used  to  represent  values  of  different  data  types.  The 
value  of  the  type  depends  on  a  parameter  supplied  to  the  constructor  for  the 
union. 

union  balance (short) { 
case  1: 

short  dailyBalance; 
case  2 : 

long  monthlyBalance; 
case  3 : 

string  balanceText; 

}; 
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d.  Container  Types: 

Containers  are  data  structures  used  to  store  and  transmit  lists  of  elements 
of  the  same  type.  Some  of  these  constructs  correspond  to  arrays  and  other  data  structures 
that  can  be  found  in  programming  languages. 

•  Arrays:  An  array  is  a  fixed-length  list  of  values  of  the  same  data  type.  The 
folloviing  example  defines  an  array  that  holds  ten  person  structs. 

person  personList [10] ; 

•  Sequences:  This  is  similar  to  an  array,  but  the  size  is  not  fixed.  The  size  of  a 
sequence  can  be  changed  dynamically,  which  provides  more  flexibility  in 
application  design.  All  values  in  the  sequence  must  be  of  the  same  type.  A 
sequence  that  is  used  within  an  IDL  file  must  be  defined  by  a  typedef  declaration, 
such  as  the  following: 


typedef  sequence  <person>  dynamicPersonList ; 


•  Strings:  Strings  in  IDL  are  implemented  as  a  sequence  of  characters.  Their 
size  can  be  fixed  or  variable  depending  on  the  declaration,  such  as  the  following 
examples: 

string  f ixedLengthString [10] ; 

string  variableLengthString; 

e.  Interfaces: 

The  interface  construct  is  used  to  describe  the  services  that  a  CORBA 
object  offers.  The  services  are  defined  in  terms  of  operations.  Operations  are  similar  to 
methods  in  object-oriented  programming  languages  or  functions  in  procedural  languages. 
An  interface  definition  includes  all  information  required  by  a  client  to  use  a  service 
provided  by  the  offering  object.  This  information  is  presented  in  terms  of  attributes 
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belonging  to  the  interface  and  the  parameters  that  are  used  by  each  operation.  The 
interface  defines  only  the  signatures.  It  is  not  involved  in  the  implementation.  Different 
implementations  can  be  provided  for  the  same  interface.  The  implementation  of  an 
object  can  be  changed  semantically  without  breaking  the  contract.  The  interface  body 
can  contain  constant  declarations,  type  declarations,  attribute  declarations,  exception 
declarations  and  operation  declarations. 

An  object  that  is  represented  by  an  interface  has  a  state  and  supports  the 
attributes  and  operations  defined  in  the  interface.  Interfaces  advertise  only  the  public 
attributes  and  operations  of  an  object.  An  object  attribute  can  be  represented  as  in  the 
following  example: 


attribute  string  name; 


Services  that  are  offered  by  the  object  are  expressed  in  terms  of 
operations.  Parameters  for  an  operation  can  be  defined  as  in,  out  or  inout  depending  on 
the  direction  of  the  parameters. 

void  setName(in  string  name) ; 
string  getNameO; 


The  following  is  an  example  interface  declaration  in  an  IDL  file. 

interface  Account { 

const  long  maximumShare=100000 ; 
attribute  string  accountHolderName; 
exception  TransactionNotAl lowed { } ; 
boolean  deposit (in  long  amount) 

raises  (TransactionNotAl lowed) ; 
double  withdraw 0  raises  (TransactionNotAl lowed)  ; 
double  getBalance 0 ; 


Interfaces  can  inherit  attributes  and  methods  from  other  interfaces  as 
shown  in  the  next  example: 
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interface  Student { 

}; 

interface  Officer{ 


}; 

interface  MilitaryStudent :  Student,  Officer{ 

}; 


f.  Exceptions: 

Exceptions  are  the  means  of  expressing  errors  that  have  occurred  while 
processing  an  invocation  of  a  method.  The  exception  construct  in  IDL  can  contain  data 
types,  but  no  operations.  An  operation  advertises  the  exceptions  that  might  occur  by  the 
“raises”  clause.  The  following  IDL  file  defines  an  interface  with  two  operations  and  an 
exception  that  might  be  thrown  by  these  operations. 

module  Bank{ 

exception  InvalidAccountNameException{string  reason}; 

interface  Accoxint{ 

attribute  long  accountNumber ; 
boolean  deposit (in  double  amount) 

raises  (InvalidAccountException) ; 
doxible  getBalance  ( ) 

raises  (InvalidAccountException) ; 

}; 

} 

There  are  two  types  of  IDL  exceptions:  user  defined  exceptions  and  standard 
IDL  exceptions.  Standard  exceptions  need  not  be  declared,  because  they  can  be  thrown 
by  any  operation.  Table  6.2  lists  the  standard  exceptions  [Ref:  14]. 


Exception  Name 

Description 

UNKNOWN 

The  unknown  exception 
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BAD_PARAM 

An  invalid  parameter  was  passed 

NO_MEMORY 

Dynamic  memory  allocation  failure 

IMP_LIMIT 

Violated  implementation  limit 

COMM_FAILURE 

Communication  failure 

INV_OBJREF 

Invalid  objet  reference 

NO_PERMISSION 

No  permission  for  attempted  operation 

INTERNAL 

ORB  internal  error 

MARSHAL 

Error  marshalling  parameter  or  result 

INITIALIZE 

ORB  initialization  failure 

NOJMPLEMENT 

Operation  implementation  unavailable 

BAD_TYPECODE 

Bad  typecode 

BAD_OPERATION 

Invalid  operation 

NO_RESOURCES 

Insufficient  resources  for  request 

NO_RESPONSE 

Response  to  request  not  yet  available 

PERSIST_STORE 

Persistent  storage  failure 

“BAD_INV_ORDER 

Routine  invocations  out  of  order 

TRANSIENT 

Transient  failure 

FREE_MEM 

Can  not  free  memory 

INVJDENT 

Invalid  identifier  syntax 

INV_FLAG 

Invalid  flag  was  specified 

INTF_REPOS 

Error  accessing  interface  repository 

“BAD_CONTEXT 

Error  processing  context  object 

OBJ_ADAPTER 

Failure  detected  by  object  adapter 

DATA_CONVERSION 

Data  conversion  error 

OBJECT_NOT_EXIST 

Nonexistent  object 

Table  6.2:  Standard  IDL  exceptions 


g.  Other  constructs'. 

Some  other  constructs  that  are  worth  mentioning  are  constant  declarations, 
typedef  statements,  forward  declarations  and  preprocessor  directives. 
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•  Constant  Declarations:  Constants  can  be  declared  for  the  following  data 
types:  integer,  character,  boolean,  floating  point  and  string.  Constants  can  have 
interface,  module  or  global  scope  depending  on  where  they  are  declared.  The 
following  is  a  declaration  of  a  constant  with  module  scope. 

module  Math{ 

const  float  pi  =  3.1415926; 

} 

•  Typedef  Declaration:  These  can  be  used  to  rename  an  existing  data  type  or 
create  new  data  types  with  a  user-given  name. 

typedef  string  [10]  AccountName; 

•  Forward  Declarations:  An  interface  needs  to  be  declared  before  it  can  be 
referenced  in  an  IDL  file.  Forward  declarations  can  be  used  to  declare  the 
interface  without  defining  it.  This  enables  mutual  dependencies  and  recursive 
definitions. 

Interface  Professor; 

Struct  School { 

Professor  AcademicAssociate; 

}; 

interface  Professor{ 
string  getNameO; 

}; 


•  Preprocessor  directives:  IDL  supports  the  preprocessing  features  fovmd  in  C 
and  C-H-  preprocessors.  Developers  can  access  the  CORBA  services  by  using 
the  “include”  statement  in  their  IDL  files,  as  shown  in  the  following  example: 
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/ / include  transactions  service 
#include  <CosTransactions.idl> 

D.  CORBA  AND  THE  WEB 

The  Internet  has  become  the  most  significant  new  medium  for  commimication 
between  and  among  businesses,  educational  and  governmental  organizations,  and 
individuals.  As  a  communications  framework,  the  Internet  provides  an  ideal  platform  for 
distributed  object  applications  and  therefore  fosters  their  growth.  [Ref:  14] 

There  are  numerous  technologies  in  use  today,  which  take  advantage  of  the 
potential  provided  by  the  Internet.  The  Common  Gateway  Interface  (CGI)  protocol  has 
been  the  dominant  model  for  Client/Server  applications  using  the  Internet  as  a  medium. 
CGI  is  a  slow,  stateless  protocol  that  is  not  suited  for  distributed  object  applications.  CGI 
launches  a  new  process  to  service  each  client  request.  Many  vendors  attempt  to 
overcome  the  weaknesses  of  CGI  by  providing  server  extensions.  These  extensions  are 
non-standard  and  some  of  them  are  platform  specific.  This  is  not  a  long-term  solution, 
because  the  Internet  is  a  heterogeneous  environment  by  nature. 

Remote  Procedure  Call  (RPC)  is  a  mechanism  that  enables  programs  running  on 
one  machine  to  make  calls  to  functions  on  another  machine  that  is  coimected  to  the 
Internet.  Remote  calls  are  blocking,  which  means  that  the  calling  application  can  not 
proceed  until  it  gets  the  results  of  the  remote  invocation.  This  brings  a  performance 
penalty.  CORBA  method  calls  can  be  declared  as  one  way,  thus  transforming  the  calls 
into  asynchronous  messages.  RPC  is  not  object-oriented,  so  it  cannot  take  advantage  of 
features  like  encapsulation,  inheritance  and  polymorphism. 

There  are  other  competing  distributed  object  models  that  are  fully  object- 
oriented.  The  two  most  notable  ones  are  Java’s  Remote  Method  Invocation  (RMI)  by 
Sxm  Microsystems  and  Distributed  Component  Object  Model  (DCOM)  by  Microsoft. 
RMI  does  not  provide  language-neutral  messaging  services.  An  object  written  for  RMI 
needs  to  be  written  in  Java  and  can  operate  only  with  objects  that  are  implemented  in  the 
same  language.  RMI  does  not  support  dynamic  invocations  and  interface  repositories.  It 
does  not  define  the  protocols  for  services  like  transactions  and  security.  DCOM  has 

serious  limitations  as  well.  CORBA  objects  have  unique  and  persistent  references  and 
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they  have  state,  where  DCOM  objects  do  not  maintain  their  state  between  connections. 
This  creates  a  problem  in  an  environment  like  the  Internet  where  there  are  numerous 
faulty  connections.  In  addition,  it  is  very  difficult  to  configure  and  run  DCOM 
applications  on  non- Windows  platforms.  DCOM  does  not  support  a  universal  naming 
service,  which  severely  limits  scalability. 

The  limitations  of  alternative  approaches  pinpoint  CORBA  as  the  leading  model 
for  providing  the  component-based  Internet-enabled  application  architecture.  We  used 
CORBA  to  implement  our  Enterprise  Information  System  prototype  for  the  Naval 
Security  Group.  The  ORB  implementation  that  we  used  was  Visigenic  Visibroker  3.3. 
The  design  process  and  implementation  issues  will  be  discussed  in  Chapter  VII. 
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VII.  IMPLEMENTATION  OF  A  WEB  BASED  CLIENT/SERVER  SYSTEM 

USING  CORBA  AND  JDBC 


A.  ORB  SELECTION 

A  variety  of  ORB  implementations  are  available,  each  with  different  features. 
The  ORB  implementation  that  we  used  for  our  EIS  prototype  was  Visigenic  Visibroker 
3.3.  The  main  reason  for  the  selection  was  the  stability  of  this  product  and  the  fact  that 
the  Java  binding  was  completely  written  in  Java,  which  meant  that  a  client  with  access  to 
the  server  via  the  web  could  download  the  ORB  on  the  fly.  Although  the  ORB 
implementation  was  by  Visigenic,  the  application  was  constructed  using  ORB- 
independent  services.  This  feature  gave  us  the  ability  to  run  the  application  on  any 
CORBA  compliant  ORB  implementation  with  only  minor  modifications  to  the  code. 

B.  APPLICATION  DESIGN  PROCESS  WITH  VISIBROKER 

To  illustrate  the  application  design  process,  we  will  first  describe  a  simple 
distributed  system  to  fully  understand  this  process.  The  following  are  the  steps  that  we 
need  to  follow  to  design  our  sample  system. 

1)  Make  an  analysis  of  the  functionality  required  of  the  system  and  divide  the 
functionality  into  objects'. 

In  our  sample  Client/Server  system  we  will  build  a  Client/Server  system 
that  provides  quotes  to  the  clients  on  demand.  The  server  object  will  listen  to 
the  client  and  respond  to  client  requests  with  a  randomly  chosen  quote  from  its 
database.  After  deciding  the  services  that  the  server  should  support,  we  need 
to  write  a  specification  for  the  server  object  using  Interface  Definition 
Language  (IDL).  The  IDL  file  can  be  created  using  any  text  editor.  This  file 
lists  the  public  attributes  and  the  public  services  of  the  objects  defined  for  the 
system.  The  information  contained  in  the  IDL  file  acts  as  a  contract  between 
objects  and  their  potential  clients.  The  client  need  not  be  concerned  how  the 
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object  is  implemented.  The  following  is  the  IDL  file  for  the  QuoteServer 
object. 

module  Example { 

interface  QuoteServer { 

string  getQuote(in  string  name, 

in  string  day,  in  string  month) ; 

}; 

} 

The  file  is  saved  as  Example.idl. 

2)  Compile  the  IDL  file  with  an  IDL  compiler  to  create  the  client  stub  code  and 
server  skeleton  code  in  the  desired  implementation  language-. 

For  our  prototype  we  used  the  Visibroker  idl2java  compiler.  We  entered 
the  following  in  the  command  line  in  the  directory  containing  Example.idl. 

prompt>  idl2java  Example.idl  -no_comments  -no_tie 

The  no_coniments  flag  indicates  to  the  compiler  that  we  do  not  wish  the 
creation  of  comments.  The  -no_tie  flag  indicates  which  type  of  server 
implementation  we  prefer.  Different  server  implementation  strategies  are 
explained  further  in  this  chapter. 

3)  The  compiler  creates  a  number  of  files  that  are  used  by  the  ORB  to  process 
remote  method  invocations-. 

One  of  the  files  generated  by  the  compiler  is  an  example  file  that  contains 
the  constructors  and  the  method  implementations  that  have  empty  bodies.  The 
developer  can  use  this  file  as  a  starting  point  when  providing  implementations 
for  the  objects.  In  our  example,  the  compiler  generated  the  following  files: 
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•  QuoteServer.javai  This  is  the  public  Java  interface  that  the  server  object 
must  implement.  The  module  name  is  used  as  the  package  name  and  all 
operations  become  public  method  declarations.  All  interfaces  extend  the 
root  object  in  the  ORB  implementation. 


package  Example; 

public  interface  QuoteServer 

extends  org.omg.CORBA. Object  { 
public  java, lang. String  getQuote { 

java. lang. String  name, 
java. lang. String  day, 
j ava . lang . String  month) ; 

} 

•  QuoteServerHelper.java\  This  is  a  Java  class  that  provides  helper 
functions  for  clients  that  want  to  use  the  services  of  a  QuoteServer  object. 

•  QuoteServerHolder.java:  Java  allows  parameters  to  be  passed  only  in  the 
in  mode.  This  Java  class  enables  the  passing  of  out  or  inout  parameters. 

•  _st_QuoteServer.javai  This  is  the  stub  class  that  the  client  uses  to  invoke 
the  operations  defined  in  the  IDL  file.  It  implements  the  interface 
QuoteServer.  This  class  has  methods  to  perform  the  marshalling  and 
unmarshalling  of  parameters. 

•  _QuoteServerImplBase.java:  This  class  is  the  server  skeleton  class  that 
implements  the  QuoteServer  interface.  It  is  responsible  for  unmarshalling 
the  arguments  for  the  QuoteServer  object.  The  implementation  provided 
by  the  developer  for  the  server  must  extend  this  class. 
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•  example  QuoteServer.java:  This  is  the  example  class  that  can  be 
expanded  to  provide  the  implementation  for  the  QuoteServer  object.  It 
contains  the  constructors  and  the  empty  method  definitions  for  the 
operations  defined  in  the  IDL  file.  The  example  class  generated  by  the 
idl2java  compiler  is  as  follows: 

package  Example; 

public  class  _example_QuoteServer  extends 

Example ._QuoteServerImplBase  { 

public  _example_QuoteServer (java. lang. String  name)  { 
super (name) ; 

} 

public  _example_QuoteServer ( )  { 

super ( ) ; 

} 

public  java. lang. String  getQuote { 

java. lang. String  name, 
java. lang. String  day, 
java . lang. String  month) { 

/ /  IMPLEMENT :  Operat ion 
return  null; 

} 

} 

4)  Write  the  implementation  for  the  server : 

The  server  must  provide  the  implementations  of  the  methods  advertised  in 

the  interface.  This  is  accomplished  by  defining  a  Java  class  that  has  public 

method  definitions  corresponding  to  the  operations  published  in  the  interface 

and  variables  wdth  accessor  methods  that  correspond  to  the  attributes  in  the 

interface.  The  developer  can  have  extra  methods  that  help  the  business  logic, 

but  these  will  not  be  accessible  by  the  client.  There  are  two  approaches  to 

implementing  the  server:  implementation  by  delegation  and  implementation 

by  inheritance.  The  client  code  is  not  effected  by  the  choice  of  the  server 
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implementation  model.  The  implementation  class  extends  the  skeleton  class 
in  the  inheritance  approach  and  implements  the  operations  interface  that  is 
generated  by  the  idl2java  compiler  in  the  delegation  approach.  We  will  use 
the  inheritance  approach  in  our  example  and  write  the  following  class 
definition: 


package  Example; 

public  class  QuoteServerlmpl  extends 
Example ._QuoteServerImplBase  { 
private  DBHelper  QuoteHelper; 

public  QuoteServerlmpl (java. lang. String  name)  { 
super (name) ; 

QuoteHelper  =  new  DBHelper () ; 

QuoteHelper . connect ( ) ; 

} 

public  QuoteServerlmpl 0  { 

super ( ) ; 

QuoteHelper  =  new  DBHelper ( ) ; 

QuoteHelper . connect ( ) ; 

} 

public  java. lang. String  getQuote { 

java. lang. String  name, 
java. lang. String  day, 
java. lang. String  month) { 


try  { 

return  QuoteHelper . getQuote (name ,  day, 

month) ; 

}  catch  (Exception  e) { 

System. out .print In ("System  Exception  in 
getQuote") ; 

return  null; 

} 

} 
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} 


The  QuoteHelper  object  has  methods  to  connect  to  a  database  server  and 
run  a  query  to  receive  the  “quote  of  the  day”.  The  implementation  of  this 
object  is  not  provided  as  it’s  not  directly  related  to  this  chapter. 

The  server  object  requires  a  class  with  a  main  function  to  act  as  a  driver. 
The  main  function  will  initialize  the  ORB,  create  a  basic  object  adapter, 
create  the  QuoteServerlmpl  object,  notify  the  Basic  Object  Adapter  (BOA) 
that  the  server  object  is  available  and  wait  for  incoming  requests.  The 
following  is  the  driver  class  for  our  example: 

class  QuoteServer  { 

static  public  void  main (String  []  args) { 
try{ 

//  Initialize  the  ORB 
org . omg . CORBA . ORB  orb  = 

org.omg.CORBA.ORB. ini t (args,  null) ; 

//  Create  the  basic  object  adapter 
org. omg. CORBA. BOA  boa  =  orb.BOA_init {) ; 

//  Create  the  QuoteServer  object 
QuoteServerlmpl  quote  =  new 
QuoteServerlmpl 0 ; 

//  Notify  the  BOA  that  the  object  is  available 
Boa. obj_is__ready (quote)  ; 

//  Wait  for  requests 
Boa .  impl__is_ready  ( )  ; 

}  catch (org. omg. CORBA. SystemExcept ion  e) { 

System. err. println(e) ; 

} 

} 
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} 


5)  Write  the  client  implementation  that  utilizes  the  services  provided  by  the 
server  object: 

The  client  need  not  be  written  in  the  same  language  as  the  server.  The 
client  application  needs  to  obtain  an  object  reference  in  order  to  make  calls. 
There  are  various  ways  the  client  can  obtain  this  reference: 

•  Asa  parameter  or  result  of  other  IDL  operations 

•  Using  the  Visigenic  proprietary  bind()  method  and  smart  agent 

•  By  reading  an  IDL  defined  object  representation  (lOR)  converted  to  a 
string  and  stored  in  a  public  location  on  the  server 

•  Resolving  a  name  within  a  CORBA  Naming  Service 

For  our  example  we  'will  implement  the  client  using  the  bind()  method. 
The  client  in  our  EIS  implementation  will  use  the  CORBA  Naming  Service  to 
obtain  a  reference  to  the  server,  due  to  the  ORB-independent  nature  of  this 
service.  The  following  is  the  code  for  the  client  for  our  QuoteServer  object: 

class  Quoted  lent  { 

String  quoteOfTheDay; 

pxiblic  static  void  main  (String  args  []  )  { 
try{ 

//  Initialize  the  ORB 
org.omg. CORBA. ORB  orb  = 

o rg.omg. CORBA. ORB. ini t (args, null) ; 

//  Bind  to  the  QuoteServer  object 
Example. QuoteServer  guoteServer  = 

Example . QuoteServerHelper . bind 

(orb,  quoteServer) ; 

//  Get  the  quote  of  the  day 
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quoteOfTheDay  =  guoteServer . getQuote 

(args[0],  args  [1]  ,  args[2]); 

//  Print  the  quote  to  the  screen 

System. out .print In (quoteOfTheDay) ; 

}  catch (org.omg.CORBA.SystemException  e) { 

System. err .print In  (e) ; 

} 

} 

} 

6)  Compile  the  client  and  the  server  code  with  the  language  compiler. 

Since  we  are  using  Java  for  the  implementation  language,  we  will  use  the 
javac  compiler  that  comes  with  the  JDKl.1.6  distribution.  In  order  for  the 
compilation  to  be  successful,  the  client  and  server  files  must  be  in  the  same 
directory  as  the  QuoteServer.idl  file.  The  reason  for  this  is  that  the  client  and 
server  classes  require  access  to  the  classes  in  the  Example  package,  which  is 
created  as  a  subdirectory  of  the  current  directory  by  the  idl2java  compiler. 
The  server  class  is  compiled  with  the  follovdng  command: 


prompt >  j  avac  QuoteServer .  j  ava 


The  client  class  is  compiled  with  the  following  command: 


prompt>  j  avac  QuoteClient .  j  ava 


7)  Start  the  server. 

Inprise  Visibroker  3.3  requires  at  least  one  OSAgent  service  to  be  running. 
The  OSAgent  provides  location  services  when  the  objects  are  using  the 
proprietary  binding  mechanism  to  locate  each  other.  It  can  be  started 
manually  or  registered  as  a  Windows  NT  service,  if  the  system  is  rurming  on 
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Windows  NT.  The  OSAgent  is  started  manually  with  the  following 
command: 

prompt >  start  osagent  -c 

Next  the  server  program  needs  to  be  started  with  the  following  command: 

prompt >  java  -DOAid=Tsession  QuoteServer 

The  “Tsession”  flag  is  required  to  disable  the  thread  pooling  capability  of 
Visibroker.  This  feature  is  used  to  improve  performance  when  multiple 
clients  share  the  server. 

8)  Start  the  client  application : 

The  client  application  needs  to  be  located  in  the  same  directory  as  the  stub 
files.  Enter  the  folloAving  command: 

prompt  >  java  Quoted  lent  client_l  1  1 

The  design  steps  for  this  example  are  illustrated  in  Figure  7.1 . 
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Figure  7.1:  IDL  design  steps 


C.  APPLETS  AND  CORBA 


The  web  browser  has  emerged  as  a  universal  front-end  for  distributed  systems. 
Intemet/Intranet  technology  provides  organizations  with  a  cost-effective  and  reliable 
medium  for  building  distributed  systems.  Although  HTTP  is  the  most  widely  used 
protocol  in  use,  any  protocol  that  is  built  on  TCP/IP  protocols  can  be  used  for  web-based 


applications.  CORBA  is  a  protocol  which  solves  the  performance,  scalability  and 
managability  problems  that  application  developers  face  when  building  distributed 
systems.  The  mediator  between  CORBA  and  a  browser  is  the  Java  applet.  Applets  are 
mobile  applications  that  are  designed  to  run  within  a  browser.  A  browser  controls  the  life 
cycle  of  an  applet.  The  applet  is  sent  to  the  browser  by  embedding  it  inside  a  Hypertext 
Markup  Language  (HTML)  page.  An  APPLET  HTML  tag  is  used  to  define  the  applet. 
The  APPLET  tag  must  include  information  about  the  name  of  the  Java  class  and  the  size 
of  the  applet  on  the  HTML  page.  The  CODE  parameter  defines  the  name  of  the  Java 
class  that  should  be  downloaded,  while  the  WIDTH  and  HEIGHT  parameters  define  the 
size  of  the  applet  within  the  HTML  page.  Optional  parameters  are  the  CODEBASE 
parameter,  which  indicates  the  directory  that  hosts  the  Java  class  file,  if  it  is  not  in  the 
same  directory  as  the  HTML  page,  and  the  PARAM  parameter,  which  is  used  to  define 
the  parameters  required  by  the  applet.  Below  is  an  HTML  page  that  can  be  used  to 
download  a  Java  applet,  which  uses  the  CORBA  Internet  Inter  ORB  protocol  (HOP)  to 
interact  with  the  server: 


<HTML> 

<HEAD> 

<TITLE>  CORBA  APPLET  </TITLE> 

<BODY> 

<applet  CODE="Gui. class"  WIDTH=:"795"  HEIGHT="594" 

HSPACE="100"  ALIGN="TOP"> 
< PARAM  NAME="org.omg. CORBA. ORBClass" 

VALUE= " com . visigenic . vbroker . orb . ORB " > 
<PARAM  NAME=ORBservices  VALUE=CosNaming> 

<PARAM  NAME=SVCnameroot  VALtrE=JavaCorba> 

</applet> 

</BODy> 

</HTML> 


The  first  parameter  in  this  case  is  used  to  force  the  browser  to  load  the  ORB 
classes  from  the  web  server.  The  other  two  parameters  are  used  by  the  applet  to  indicate 
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that  the  applet  requires  the  CORE  A  Naming  Service  to  find  the  server  object  and  that  the 
root-naming  context  is  JavaCorba.  The  CORBA  Naming  service  vv^ill  be  explained  in  the 
next  section.  Figure  7.2  shows  how  HTTP  and  CORBA  protocols  are  used  to  provide 
interaction  between  the  server  and  the  client. 


HTTP 


Figure  7.2:  Applet-CORBA  Interaction 


The  system  is  initialized  by  placing  the  applet  and  other  Java  class  files  on  the 

web  server.  The  web  browser  will  request  the  page  that  embeds  the  applet  when  the  user 

enters  the  Uniform  Resource  Locator  (URL)  name  for  the  page.  The  web  server  will 

return  the  web  page  to  the  browser  using  the  HTTP  protocol.  The  applet  and  the  Object 

Request  Broker  classes  will  then  be  sent  with  the  page.  The  browser  will  recognize  the 

APPLET  tag  in  the  page  and  activate  the  Java  virtual  machine.  The  Java  virtual  machine 

will  create  an  instance  of  the  applet  and  in  the  process  bind  the  applet  to  the  server  by 

using  HOP.  When  the  user  requests  a  service  from  the  server,  the  applet  will  create  the 

proper  CORBA  request  and  send  the  request  to  the  server  using  HOP.  The  server  will 

return  the  results  of  the  request  using  the  same  protocol.  The  applet  will  then  translate 
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the  results  and  display  them  to  the  user.  The  only  problem  in  this  scenario  is  the  security 
model  that  has  been  built  in  Java.  The  security  model  in  Java  allows  applets  to  connect 
only  to  the  host  system  from  which  they  have  been  downloaded.  This  is  called  “The  Java 
Sandbox”.  The  main  reason  for  this  limitation  is  that  once  an  applet  is  run  on  a  machine 
inside  an  organization’s  firewall,  it  has  the  privileges  of  the  user  on  whose  behalf  it  is 
executing.  The  applet  can  access  private  information  and  transmit  it  via  a  TCP/IP 
connection  without  the  user’s  knowledge.  This  restriction  seriously  limits  the  capabilities 
of  a  distributed  system  that  uses  applets.  Fortunately  with  the  new  Security  model  in 
JDKl.l  it  is  possible  to  grant  applets  fine-grained  access  rights  beyond  the  “Sandbox 
Model”.  This  is  achieved  by  digitally  signing  the  applets.  In  Visibroker  3.3  a  proprietary 
mechanism  has  been  developed  to  coimter  the  limitations  placed  on  the  applet.  A  proxy 
server  named  “Gatekeeper”  enables  the  forwarding  of  messages  from  the  client  applet  to 
a  server  and  then  returning  the  results  from  the  server  to  the  client.  The  Gatekeeper  acts 
only  as  a  forwarder  of  HOP  packets,  therefore  it  is  vendor-neutral.  The  client  may  be 
using  Visibroker,  while  the  server  uses  another  ORB  implementation.  Figure  7.3 
illustrates  the  operation  of  the  Gatekeeper. 


Figure  7.3:  Operation  of  the  Gatekeeper 


D.  CORBA  NAMING  SERVICE 

Every  CORBA  compliant  ORB  must  support  the  NAMING  Service  defined  in  the 
CORBA  Services  Specification.  Visibroker  currently  implements  the  following  Object 
Services: 


•  Naming  Service 
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•  Event  Service 

•  Security  Service  over  Secure  Socket  Layers 

•  Transaction  Service 

We  did  not  use  the  bind  utility  provided  by  Visibroker  3.3  in  our  prototype. 
Instead  we  used  the  vendor  neutral  CORBA  Naming  Service.  The  problem  associated 
with  using  the  bind  utility  in  Visibroker  is  non-portability.  All  components  in  the 
distributed  system  must  have  Visibroker  as  their  ORB  and  the  ORB  can  not  be  changed 
without  taking  out  all  binding  method  calls  and  replacing  them  with  Naming  Service 
method  calls.  The  Naming  Service  has  a  very  flexible  structure  that  allows  developers  to 
create  their  own  naming  hierarchies. 

Every  CORBA  object  can  be  located  by  using  a  series  of  bindings  that  end  in  a 
simple  name.  The  Naming  Service  forms  a  hierarchy  of  name  components  in  the  form  of 
a  tree  structure.  Each  name  component  holds  a  reference  to  an  object.  This  object  can  be 
another  name  component  or  the  instance  of  the  object  that  is  sought.  Each  name 
component  forms  a  name  context.  The  Naming  Service  traverses  the  name  components 
imtil  it  finds  the  instance  of  the  object  to  which  it  returns  a  reference  or  ends  its  traversal 
without  finding  the  object  and  throws  an  exception.  This  process  is  called  resolving  a 
name.  To  create  an  association  between  a  name  and  an  object  is  called  binding.  The 
Naming  Service  maintains  a  database  of  bindings  between  names  and  object  references. 
The  binding  and  resolving  process  is  illustrated  in  Figure  7.4. 

•  Binding  an  object  to  a  name:  In  order  to  bind  a  name  to  an  object  the  first 
task  must  be  to  acquire  a  reference  to  the  Naming  Service.  This  is 
accomplished  as  follows: 

org.omg. CORBA. Object  nameServiceObj  = 

orb.resolve_initial_references (NameService) ; 

org . omg . CosNaming . NamingContext  nameService  = 
org .  omg .  CosNaming .  NamingContextHelper . 

narrow (nameServiceObj ) ; 
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The  next  step  is  to  construct  the  name  to  which  the  object  will  be  bound: 


NameComponent  nameRoot  = 

new  NameComponent (QuoteServer,  ; 


NameComponent [ ]  QuoteServerName  =  { nameRoot } ; 


Next  the  bind  method  of  the  Naming  Service  should  be  called.  We 
preferred  to  use  the  rebind  method  in  order  to  avoid  exceptions  if  the  name 
was  previously  bound. 


NameService , rebind (QuoteServerName,  QuoteServer ) ; 

•  Resolving  a  name  to  obtain  an  object  reference:  The  client  of  the  Naming 
Service  needs  to  obtain  a  root  naming  context,  then  traverse  through  the 
naming  context  to  obtain  a  reference  to  the  object  for  which  it  is  searching. 
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The  client  obtains  a  reference  to  the  root  naming  context  with  the  following 
code: 


org.omg^CORBA. Object  rootRef  = 

orb. resolve_initial_reference (NameService) ; 


NamingContext  rootContext  = 

NamingCont extHelper . narrow ( rootRef )  ; 

The  next  step  is  to  create  the  name  of  the  object: 


NameComponent [ ]  ob j  Name  = 

{new  NameComponent (QuoteServerName,  "  ”  )}; 

Finally,  the  client  asks  the  Naming  Service  to  resolve  this  name 
and  return  a  reference  to  the  object  bound  to  that  name: 


Example. QuoteServer  quoteServer  = 

Example . QuoteServerHelper . narrow 

(nameService . resolve (objName) ) ; 


•  Running  the  Naming  Service  with  Visibroker:  The  Visibroker 

implementation  of  the  Naming  Service  can  be  executed  with  the  following 
command.  This  service  must  be  running  on  the  server  to  allow  clients  to 
access  objects  using  the  Naming  Service. 


prompt>  vbj 


-DORBServices=CosNaming 

-DSCVnameroot=JavaCorba 

-DJDJrenameBug 

com . visigenic . vbroker . services . CosNaming . 

ExtFactory 


JavaCorba  namingLog 


By  using  the  Naming  service,  the  client  can  be  completely  vendor- 
independent.  This  means  that  the  ORB  on  the  server  can  be  replaced  without 
changing  a  single  line  of  client  code. 
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E.  DESIGN  AND  IMPLEMENTATION  OF  THE  EIS  PROTOTYPE 


1.  Design 

A  logical  plan  should  be  followed  in  the  design  process  of  a  distributed  system. 
The  first  phase  should  be  to  identify  the  objects  that  will  be  used  in  the  system.  Different 
methodologies  can  be  employed  to  work  from  the  problem  statement  and  come  up  with  a 
division  of  functionality  between  objects  that  make  up  the  system.  The  content,  behavior 
and  interaction  of  objects  are  described  in  the  information  architecture  of  the  application. 
A  suggested  methodology  for  developing  an  information  architecture  in  a  distributed 
system  is  as  follows,  the  reader  should  consult  to  the  reference  for  a  more  detailed 
explanation  of  the  methodology  [Ref:  12]: 

•  Perform  domain  analysis 

•  Model  the  domain  with  UML  use  cases,  which  present  the  functionality  of  the 
system  when  combined  together 

•  Develop  an  object  model  from  use  cases 

•  Develop  behavioral  models,  state  diagrams,  or  object  interaction  diagrams  for 
behavior  intensive  or  time-critical  areas  of  the  system 

•  Partition  the  object  model  into  subsystems  and  allocate  the  subsystems  to 
CORBA  servers 

•  Design  the  interface  with  IDL 

The  system  that  we  built  needed  to  satisfy  the  requirements  for  the  NAVSECGRU 
to  establish  and  maintain  a  central  database  that  could  be  accessed  from  anywhere  in  the 
world.  The  end  user  would  have  computer  competency  ranging  from  expert  to  novice. 
An  assumption  that  the  end  user  would  be  jjroficient  in  using  Windows  based 
applications  was  made.  The  specification  for  the  database  was  not  concrete,  so  that  the 
database  and  its  relational  tables  could  be  designed  or  modified  according  to  the 
organization’s  needs.  The  system  would  even  be  able  to  swap  the  back-end  DBMS 
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without  requiring  extensive  modifications.  We  took  a  subset  of  the  information  stored  in 
a  typical  Navy  command  and  came  up  with  the  following  use  cases: 

•  Enter  personnel  information 

•  Modify  personnel  information 

•  View  personnel  information 

•  Enter  budget  and  supply  information 

•  View  budget  and  supply  information 

•  Enter  command  information 

•  Modify  command  information 

•  View  command  information 

•  Enter  operational  information 

•  View  operational  information 

The  next  step  in  the  design  phase  of  our  EIS  was  to  produce  the  object  model, 
which  would  provide  a  basis  for  the  objects  in  the  system  and  the  interaction  between 
them.  The  classes  with  specific  responsibilities  have  been  identified  in  this  phase.  Figure 
7.5  shows  the  simplified  EIS  class  diagram.  The  Unified  Modeling  Language  (UML) 
notation,  which  has  been  accepted  as  the  standard  object  modeling  technique  by  the 
OMG,  was  used.  The  reader  can  find  further  information  regarding  UML  in  Appendix  A. 

We  then  defined  the  interaction  between  the  objects  that  made  up  the  system,  with 
the  use  of  sequence  diagrams.  Sequence  diagrams  give  a  clear  picture  of  the  interaction 
between  objects  in  a  specified  scenario.  Each  use  case  may  be  broken  down  into  a 
number  of  scenarios  and  each  scenario  can  then  be  represented  with  a  sequence  diagram. 
The  following  scenarios  were  defined  as  an  example  for  the  “View  operational 
information”  use  case: 

•  View  all  sea  missions  in  a  given  period  of  time 

•  View  sea  missions  for  a  type  of  platform  in  a  given  period  of  time 

.•  View  sea  missions  according  to  their  types  in  a  given  period  of  time 

•  View  sea  missions  in  an  exercise 
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•  View  sea  missions  executed  by  a  specific  platform  in  a  given  period  of  time 

•  View  all  air  missions  in  a  given  period  of  time 

•  View  air  missions  flown  by  a  specific  platform 

•  View  air  missions  according  to  their  types  in  a  given  period  of  time 

•  View  air  missions  flown  in  an  operational  area  in  a  given  period  of  time 

•  View  air  missions  flown  by  a  squadron 


Figure  7.5:  EIS  class  diagram 

The  user  of  the  EIS  is  the  performer  for  each  of  these  scenarios.  The  user  directly 
interacts  with  the  EIS  in  order  to  achieve  a  specific  goal.  Each  goal  is  accomplished 
through  the  successful  completion  of  a  series  of  actions.  The  sequence  of  interactions 
that  can  occur  under  certain  conditions  makes  up  the  scenario.  A  sequence  diagram 
shows  the  steps  of  interactions  and  the  resulting  state.  Sequence  diagrams  can  be  used  to 


further  specify  the  behaviors  that  should  be  expected  of  an  object.  We  used  sequence 
diagrams  to  define  the  services  that  each  object  in  the  system  should  provide.  Figure  7.6 
shows  the  sequence  diagram  for  the  “Add  Air  Mission”  scenario  as  an  example. 


Figure  7.6:  “Add  Air  Mission”  sequence  diagram 
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At  the  end  of  the  design  phase  we  had  a  very  concrete  picture  of  the  objects  and 
the  functions  that  should  be  supported  by  each  object.  The  next  step  was  to  write  the 
Interface  Definition  Language  (IDL)  specification  that  would  serve  as  a  contract  between 
the  client  and  server  parts  of  the  system.  We  provided  definitions  for  the  dfjta  structures 
and  the  interfaces  for  the  CORBA  server  objects  within  the  system  in  the  IDL  file 
NavSec.idl.  We  will  cover  different  parts  of  this  file  as  we  continue  with  the  definition  of 
objects  in  the  system.  The  complete  file  listing  can  be  found  in  Appendix  B. 

2.  Implementation 

Our  EIS  prototype  is  built  on  a  three-tiered  Client/Server  system.  The  benefits  of 
this  choice  have  been  covered  in  the  Client/Server  chapter.  The  client  interface  is 
implemented  using  the  JApplet  class  of  the  Java  Swing  package.  This  is  a  “thin”  client 
implementation,  which  means  that  the  business  logic  is  implemented  on  the  middle  tier 
vice  the  firont-end.  JApplet  class  extends  the  Applet  class  in  the  Abstract  Window 
Toolkit  (AWT)  package.  We  chose  to  use  Swing,  because  it  provided  the  developer  with 
a  wide  range  of  user  interface  widgets  that  reduced  development  time.  Since  none  of  the 
popular  browsers  supported  Swing  at  the  time  of  development,  the  installation  of  the 
JDKl.l  plug-in  is  required  for  each  client.  If  a  user  that  has  not  installed  the  JDKl.l 
plug-in  visits  the  page  hosting  the  client  interface,  the  user  is  automatically  directed  to 
the  JavaSoft  site  where  the  plug-in  can  be  downloaded.  When  the  plug-in  is  installed,  the 
client  then  has  access  to  all  of  the  Swing  package  classes.  The  client  JApplet  class 
requires  loading  of  the  ORB  by  defining  it  as  a  parameter.  The  Naming  Service  is  also 
defined  as  a  parameter  and  requires  loading.  The  client  JApplet  uses  the  Naming  Service, 
so  that  the  distributed  system  is  as  ORB-independent  as  possible. 

During  operation  of  the  EIS,  the  client  invokes  mediods  on  the  CORBA  server 
objects  in  the  middle  tier.  These  server  objects  interact  with  objects  that  use  JDBC  to 
execute  queries  on  a  relational  DBMS.  This  interaction  constitutes  the  third  tier.  Only 
server  objects  can  interact  with  the  back-end  database,  which  enforces  the  business  rules 
of  the  system  within  the  middle  tier  and  keeps  all  information  stored  in  the  database  in  a 
consistent  state.  Figme  7.7  shows  how  the  EIS  prototype  is  divided  into  three  tiers. 
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We  will  discuss  in  detail  each  of  the  three  tiers  that  make  up  our  EIS 
Client/Server  system  and  discuss  the  objects  that  operate  within  each  tier  in  the  following 
sections. 


Tier  1-  Presentation  Object 


Tier  2-  CORBA  Server  Object  Tier  3-  Data  Server 


Figure  7.7:  Objects  in  the  EIS  architecture 


3.  Data  Server 

The  data  server  for  the  EIS  prototype  consisted  of  a  database  instance  on  a 
SQLServer  6.5  database  server.  The  database  instance  was  named  NSGDB  after  “Naval 
Security  Group  Database”.  This  instance  consisted  of  six  logical  subdivisions  and 
twenty-three  tables.  The  structure  of  the  NSGDB  database  is  outlined  in  Figure  7.8. 
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NSGDB 


Figure  7.8:  NSGDB  Database  structure 


A  helper  class  called  DBHelper.java  was  created  to  access,  query  and  manipulate 
this  database.  The  Connect  Software  FastForward  Microsoft  JDBC  driver  was  used  for 
access  to  the  NSGDB  database.  The  following  is  a  brief  description  of  the  DBHelper 
class: 


83 


•  DBHelper.java:  The  IDL  file  does  not  advertise  this  class.  It  is  a  local  class 
that  provides  methods  for  connecting  to  the  back-end  database,  executing 
SQL  queries  with  user  defined  parameters  and  disconnecting  from  the 
database.  DBHelper  objects  establish  a  connection  to  the  NSGDB  database 
instance  when  they  are  created  and  maintain  this  connection  in  order  to  avoid 
the  penalty  of  establishing  a  new  connection  with  the  DBMS  whenever  a  new 
client  makes  a  request.  The  following  code  shows  the  method  that  is  used  to 
establish  a  connection  with  the  database: 


piablic  void  connect  (String  address,  String  db. 

String  id,  String  pw)  throws  Exception 

try{ 

//  Load  the  FastForward  JDBC  driver 
Class . f orName (connect .microsoft . 

Microsof tDriver) ; 


//  Create  the  address  for  the  database 
String  url  =  ”jdbc:  ff -microsof t : //”  + 
address  +  ”:1433/"  +  db; 


//Get  a  connection  to  the  database 

Con  =  DriverManager .getConnection (url  ,  id, 

pw)  ; 


}  catch (  Exception  e) { 

System. err. println (System  exception  in 

connect) ; 

System. err .println (e) ; 

} 

} 

Once  the  connection  with  the  database  is  created,  it  is  possible  to  run 
queries  on  the  database  and  return  the  results  to  the  requesting  object.  The 


84 


method  definition  provided  as  an  example  on  the  next  page  is  used  to  insert 
information  about  a  new  department  into  the  database: 

public  boolean  addDepartment (  Navy .department Struct 

depar tmentDa t a ) 
throws  Exception 

{ 

try  { 

pstmt  =  con.prepareStatement ( 

"  INSERT  INTO  DEPARTMENT  (  "  + 

"  COMMAND_ID,  DEPARTMENT_ID,  TITLE  ,  "  + 

"  DEPARTMENT_HEAD_SSN, »+ 

"  DEPARTMENT_CHIEF_SSN.,  ”  + 

”  TELEPHONE,  EMAIL  ) "+ 

"  VALUES  {?,?,?,?,?,?,?  )”); 

pstmt . setstring (  1,  departmentData . commandid) ; 
pstmt . setstring 

(  2 ,  departmentData .  departmentid)  ; 
pstmt. setstring (  3,  departmentData. title) ; 
pstmt .setstring (  4,  departmentData. headSsn) ; 
pstmt . setstring (  5 ,  departmentData . chief Ssn) ; 
pstmt . setstring (  6,  departmentData. telephone) ; 
pstmt . setstring (  7 ,  departmentData . email ) ; 
pstmt . executeUpdate ( ) ; 
pstmt  .close  0  ; 
con.commitO; 

System,  out .  print  In  ("Query  run  successfully")  ; 
return  true; 

}  catch (Exception  e)  { 

System . err . println 

("System  Exception  in  addDepartment"); 

System. err.println(e)  ; 
throw  e; 

} 

} 


The  DBHelper  class  provides  the  following  method  definition  to  close  the 
connection  with  the  database: 


public  void  closeConnection ()  throws  Exception  { 
try  { 

System. err .print In ("Closing  connection")  ; 
con. close ( ) ; 

}  catch (Exception  e)  { 

System . err . println 
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("System  Exception  in  closeConnection"); 

System. err .print In (e) ; 
throw  e; 

} 

} 

The  complete  code  listing  for  the  DBHelper  class  can  be  found  in 
Appendix  C. 

4.  CORBA  Server 

The  CORBA  server  forms  the  broker  between  the  DBHelper  class  that  holds  a 
connection  to  the  database  and  the  client  interface  located  in  the  web  browser.  The 
CORBA  server  classes  expose  two  IDL  interfaces  to  the  client.  These  are  the 
“NavSecDispenser”  and  “NavSec”  interfaces.  The  following  classes  define  the 
functionality  of  the  CORBA  server  component: 

•  NavSecServer.java:  This  class  acts  as  the  driver  for  the  server  classes. 
NavSecServer  accomplishes  the  following  tasks: 


Initializes  the  ORB  with  arguments  passed  from  the  command  line: 

//  Initialize  the  ORB 
org.omg. CORBA. ORB  orb  = 

org . omg . CORBA . ORB . init (args ,  props ) ; 

Creates  a  new  NavSecDispenserlmpl  object  and  passes  it  the  number  of 
NavSecImpl  objects  that  it  should  create  as  a  parameter: 

//  Create  the  NavSecDispenser  object 
NavSecDispenserlmpl  mydispenser  =  new 

NavSecDispenserlmpl (args,  "My  Dispenser" , 

noOf Instances) ; 

Exports  the  NavSecDispenserlmpl  object  to  the  ORB: 


//  Export  the  newly  created  object 
orb . connect (mydispenser) ; 
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Gets  a  reference  to  the  Naming  Service  and  binds  the 
NavSecDispenserlmpl  object: 


/ /  Get  a  reference  to  the  Naming  service 
org.omg. COREA. Object  nameServiceObj  = 

orb. resol ve_initial_references  ("NameService") ; 

if  (nameServiceObj  ==  null)  { 

System. out. println  ("nameServiceObj  =  null"); 
return ; 

} 

org .  omg .  CosNaming . NamingContext  nameService  = 
org . omg . CosNaming . NamingContextHelper . 

narrow (nameServiceObj ) ; 

if  (nameService  ==  null)  { 

System. out .println  ("nameService  =  null”) ; 
return; 

} 

//  bind  the  NavSecDispenserlmpl  object  in  the  Naming 
/ /  service 

NameComponent  []  mydispensemame  =  {new 

NameComponent ( "NavSecDispenser " ,"")}; 

nameService .  rebind  (mydispensemame ,  mydispenser )  ; 


The  rebind  method  of  the  Naming  Service  is  used  to  replace  any  previous 
bindings  to  the  object. 


Waits  imtil  the  program  is  shut  down  manually: 


/ /  wait  forever  for  current  thread  to  die 
Thread .  currentThread  ( )  .  joinO  ; 

•  NavSecDispenserImpLjavax  NavSecDispenserlmpl  is  a  factory  class.  This 
class  instantiates  the  pool  of  NavSecImpl  objects.  It  implements  the  methods 
defined  in  the  NavSecDispenser  interface,  which  is  defined  in  the  Navy.idl 
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file.  These  methods  are  advertised  to  clients  that  will  be  using  them  to  acquire 
a  reference  to  a  NavSecImpl  server  object : 

Interface  NavSecDispenser  { 

NavSec  reserveNavSecObject  () 

raises  (navsecException) ; 
void  releaseNavSecObject (in  NavSec 

navsecObject) 
raises  (navsecException) ; 

}; 


The  constructor  for  the  class  gets  a  reference  to  the  ORB,  then  instantiates 
a  pool  of  NavSecImpl  objects  and  exports  them  to  the  ORB.  The  number  of 
NavSecImpl  objects  to  be  instantiated  is  passed  to  the  constructor  as  an 
argument.  The  following  is  the  code  for  the  constructor  of  the  class: 


public  NavSecDispenserlmpl  (java .  lang . String  [] 

args, 

j ava . lang . String  name , 
int  number)  { 

//  Register  the  name  with  the  ORB 
super (name) ; 

try{ 

//  gst  reference  to  orb 
org.omg.CORBA.ORB  orb  = 

org . omg . CORBA . ORB . ini t ( args ,  nul 1 ) ; 

//  prestart  n  NavSecImpl  Objects 
numObjects  =  number; 

for  (int  ix  =  0;  ix  <  numObjects;  ix++)  { 
navSec[ix]  =  new  NavSecStatus ( ) ; 
navSec [ix] .ref  = 

new  NavSecImpl  ( "NavSec”  +  (ix+1)); 
orb. connect (navSec [ix] .ref) ; 

System . out . print In 

("NavSec"+  (ix+l)+  "is  ready"); 


} 
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} 


}  catch (Exception  e) { 

System. err .println(e) ; 

} 

NavSecDispenserlmpl  maintains  references  to  these  objects  in  an  array  of 
NavSecStatus  objects.  When  a  client  asks  for  the  reserveNavSecObjectQ 
service,  the  implementation  finds  a  NavSecImpl  object  that  is  available  by 
checking  the  “inUse”  flag  in  the  NavSecStatus  object  and  returns  a  reference 
to  this  object  to  the  client  via  the  ORB.  If  there  are  no  available  NavSecImpl 
objects  a  null  value  is  returned.  The  following  code  shows  how  this  is 
accomplished: 

piiblic  Navy.NavSec  reserveNavSecObject  (  ) 
throws  Navy.navsecException{ 

//  Find  an  available  NavSecImpl  object  and 

//  return  a  reference 

for  (int  ix  =  0;  ix  <  numObjects;  ix+‘f)  { 

if  ( InavSec [ix] . inUse) { 

navSec [ix] . inUse  =  true; 

System . out . print In 

("NavSec"  +  (ix+1)  +  ”  reserved,"); 
return  navSec[ix] .ref; 

} 

} 

return  null; 

} 

When  a  client  is  finished  executing  any  queries,  it  releases  the 
NavSecImpl  object  by  calling  the  IDL  advertised  releaseNavSecObjectQ 
method  on  the  NavSecDispenserlmpl  object.  The  NavSecDispenserlmpl 
object  returns  the  reference  to  the  pool  of  available  objects  by  modifying  the 
objects’  inUse  flag.  The  following  code  shows  how  this  is  accomplished: 
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public  void  releaseNavSecObject (Navy .NavSec 

navsecObject ) 

throws  Navy. navsecExcept ion  { 

//  Go  through  the  array  of  NavSecImpl  objects 
//  find  the  right  one  and  change  flag  to  not 
//  busy 

for  (int  ix  =  0;  ix  <  numObjects;  ix++) { 
org.omg.CORBA. Object  element  = 

(org.omg.CORBA. Object)  navSec[ix] ,ref; 
org.omg.CORBA. Object  inelement  = 

(org . omg . CORBA . Ob j  ect )  navsecOb j  ect ; 

if  (element ._is_equivalent (inelement) ) { 
navSec [ix] . inUse  =  false; 

System. out .print In 

("NavSec"  +  (ix+1)  +  "  released."); 
return; 

} 

} 

System.out.println ("Reserved  Object  not  found"); 
return; 


} 

•  NavSecStatus.java:  This  class  maintains  a  handle  to  NavSec  objects  by 
pairing  a  reference  to  NavSecImpl  object  with  a  Boolean  value  indicating 
whether  the  object  is  in  use  or  available.  The  following  is  the  definition  for 
this  convenience  class: 


class  NavSecStatus{ 
NavSecImpl  ref; 
boolean  inUse; 
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} 


NavSecStatus () { 
ref  =  null; 
inUse  =  false; 

} 


NavSecImplJava:  This  class  implements  the  NavSec  interface  and  is 
therefore  responsible  for  providing  implementations  for  the  services 
advertised  in  this  interface,  Clients  that  execute  queries  on  the  NSGDB 
database  instance  use  these  services.  Each  NavSecImpl  object  instantiates  a 
DBHelper  object  Avhen  it  is  created.  The  DBHelper  class  provides  JDBC 
functionality  required  to  execute  queries  and  return  results  to  the  calling 
client.  The  results  are  returned  as  a  Vector  by  the  DBHelper  object,  which  is 
copied  into  a  CORBA  struct  of  the  proper  size  required  by  this  class.  An 
instance  of  this  class  is  constructed  by  calling  the  following  constructor: 


ptiblic  NavSecImpl  (java. lang. String  name)  { 

//  Register  the  name  with  the  ORB 
super (name) ; 
try  { 

myDBHelper  =  new  DBHelper () ; 
myDBHelper . connect 

( "www.dbase-research.es  .nps.navy.mil" , 

"NSGDB",  "sa",  ""); 

System,  out  .println 

("DBHelper  Object  "  +  name  +  "  Created"); 
instanceName  =  name; 

}  catch  (Exception  e) { 

System.out.println( "System  Exception  ")  ; 

} 

} 

The  name  passed  to  the  constructor  is  used  to  register  an  instance  of  the 
class  to  the  ORB  implementation.  The  NavSecImpl  answers  the  requests  of 
the  clients  by  making  method  calls  on  the  DBHelper  object  to  which  it  holds 
a  reference.  DBHelper  executes  the  proper  SQL  query  by  using  the  JDBC 
classes.  The  results  of  the  query  are  then  returned  to  the  NavSecImpl  object 
as  a  Java  Vector  object.  NavSecImpl  then  translates  the  results  into  a 
CORBA  sequence  of  structs,  so  that  they  can  be  sent  back  to  the  client  using 
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the  ORB.  The  following  is  the  definition  of  such  a  method  used  by  the 
CORE  A  client  to  get  a  sailor’s  leave  data  stored  in  the  DBMS: 

public  Navy .  leavedescS true t  []  getLeaveData 
(  java. lang. String  sailorSsn, 
java.lang. String  lastName  )  { 
try  { 

Navy. leavedescS truct []  leaveData; 

Vector  leaves  = 

myDBHelper . getLeaveData 

(sailorSsn, lastName) ; 

leaveData  = 

new  Navy .  leavedescStiruct  [leaves  .  size  0  ]  ; 
leaves . copyinto (leaveData) ; 
return (leaveData) ; 

}  catch  (Exception  e)  { 

System . out . print In 

("System  Exception  in  getLeaveData”); 
return  null; 

} 

} 

There  are  40  methods  in  our  EIS  prototype  that  can  be  used  by  the  client 
to  insert,  modify  or  query  database  data.  The  NavSecImpl  class  provides  an 
implementation  for  each  of  these  IDL  advertised  methods  by  calling  proper 
DBHelper  class  methods.  Complete  source  code  for  the  NavSecImpl  class 
can  be  found  in  Appendix  C. 

5.  Applet  Client 

The  client  side  of  the  Naval  Security  Group  EIS  is  comprised  of  85  separate 
classes.  The  base  class  that  manages  all  of  the  other  classes  is  named  Gui.java.  This 
class  extends  the  JApplet  class  in  the  java.swing  package,  which  in  turn  extends  the 
Applet  class  in  the  java.awt  package.  The  inheritance  and  composition  relationships  of 
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the  Gui  class  are  shown  in  Figure  7.9.  Each  of  the  panels  that  belong  to  the  GUI  class 
extends  the  JPanel  class  in  the  java.swing  package,  which  extends  the 
java.awt.Component  class.  The  inheritance  relation  for  the  JPanel  class  is  not  shown  to 
keep  the  diagram  simple. 


Figure  7.9:  GUI  class  diagram 


■The  Panel  classes  are  themselves  comprised  of  the  panels  that  allow  the  user  to 
enter,  modify  or  view  information  maintained  in  the  back-end  database.  Figure  7.10 
shows  the  class  diagram  for  the  AdminPanel  class. 


Each  GetXXXBean  class  contains  two  classes  that  extend  java.swing. JPanel.  The 
first  JPanel  is  used  to  specify  the  input  parameters  for  a  query  to  be  executed  on  the 


93 


database,  while  the  second  is  used  to  display  the  results  of  the  query  to  the  client.  We  will 
go  over  the  basic  components  that  make  up  the  client  interface  in  the  following  sections. 

•  GuLjava:  The  GUI  class  holds  a  reference  to  six  panels  that  enable  the  client 
to  use  all  of  the  services  offered  by  the  EIS.  When  the  browser  creates  an 
instance  of  the  GUI  class,  it  creates  an  instance  of  the  CorbaBean  class  and 
passes  a  reference  to  itself.  The  following  code  shows  how  this  is  implemented: 

CorbaBean  corbaBean  =  new  CorbaBean (this) ; 


The  instance  of  the  CorbaBean  class  is  visible  to  the  entire  GUI  class,  so 
all  of  the  widgets  that  make  up  the  interface  have  access  to  its  methods.  The  other 
objects  will  use  the  methods  of  the  CorbaBean  object  to  invoke  the  IDL 
advertised  methods  of  the  server. 

When  the  browser  initializes  the  applet,  a  panel  is  displayed  for  the  client 
to  enter  a  username  and  password.  If  the  client  is  authorized  he  will  then  be  able, 
to  access  the  panels  that  display  the  operations  that  can  be  performed  by  the 
client.  The  client  will  interact  with  these  panels  to  input,  modify  or  view 
information  stored  in  the  back-end  DBMS.  When  the  client  leaves  the  HTML 
page  that  hosts  the  GUI  applet,  the  browser  will  invoke  the  stop()  method  on  the 
GUI  object.  The  corbaBean  object  will  be  notified  to  release  the  connection  with 
the  CORBA  server  in  the  stopQ  method  of  the  GUI  object  as  shown  in  the 
following  code: 

public  void  stopO  { 
try{ 


corbaBean.  releaseObject  0  / 

System. err .println( "Released  the  orb."); 
}  catch (Exception  e) { 

System. err .println ( "Could  not  release  the 
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•  CorbaBeanjava:  This  is  a  helper  class  that  will  be  used  to  invoke  methods  of 
the  CORBA  server  that  the  client  interacts  with.  The  CorbaBean  object  needs  a 
reference  to  the  CORBA  server  object  in  order  to  execute  the  IDL  advertised 
methods  of  the  server  object.  The  first  task  that  is  performed  by  the  CorbaServer 
object  is  to  initialize  the  ORB  with  the  following  lines  of  code: 

//initialize  the  orb 

org.omg. CORBA. ORB  orb  =  org. omg. CORBA. ORB . init 

(parent,  null) ; 

Applets  have  a  different  pattern  of  initializing  the  ORB.  A  reference  to 
the  applet  must  be  passed  to  the  init()  method  of  the  ORB  class.  We  passed  a 
reference  to  the  GUI  class  in  the  code  above.  The  next  step  that  should  be 
accomplished  by  the  CorbaBean  object  is  to  get  a  reference  to  the  Naming 
Service: 

//  Get  a  reference  to  the  Naming  service 

org.omg. CORBA. Object  nameServiceObj  = 

orb. resol ve_initial_references ( "NameService") ; 

if  (nameServiceObj  ==  null)  { 

System . out . println ( "nameServiceObj  =  null " ) ; 
return ; 

} 

org.omg, CosNaming.NamingContext  nameService  = 
org .  omg .  CosNaming .  NamingContextHelper . 

narrow (nameServiceObj ) ; 

if  (nameService  ==  null)  { 

System . out . println ( "nameService  =  null " ) ; 
return; 

} 
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Then  the  name  of  the  server  object  must  be  created.  With  the  following 
line  of  code,  we  indicate  the  name  of  the  server  object  that  we  want  to  obtain  a 
reference  to  as  “NavSecDispenser”  and  the  root  context  as  null: 


org.omg.CosNaming.NameComponent  []  mydispensername  = 

{ new  org .  omg .  CosNaming .  NameComponent 

{ "NavSecDispenser" ,  " ” ) }  ; 

The  next  step  is  asking  the  NavSecDispenserHelper  object,  which  holds 
the  stub  files  for  the  client,  to  return  a  reference  to  the  CORBA  server  object  with 
the  indicated  name: 


myDispenser  = 

Navy . NavSecDispenserHelper . narrow 
(nameService. resolve (mydispensername) ) ; 

The  NavSecDispenser  is  an  IDL  advertised  CORBA  factory  object  that 
can  be  used  by  the  client  to  obtain  a  reference  to  the  NavSec  server  object.  The 
NavSec  server  object  provides  an  implementation  of  the  IDL  defined  server 
methods  that  may  be  invoked  by  the  client.  A  reference  to  the  NavSec  object  is 
obtained  by  calling  the  reserveNavSecQ  object  of  the  NavSecDispenser  object: 

myNavSec=  myDispenser. reserveNavSecOb j ect () ; 

The  CorbaBean  object  maintains  this  reference  as  a  class  variable  and 
invokes  the  proper  methods  on  the  NavSec  object  when  requested.  The  method 
defined  below  is  used  by  panel  objects  to  change  the  data  stored  in  the  DBMS 
regarding  a  command  division: 

public  synchronized  boolean  changeDepartment 

(Navy.departmentStruct  myDepartmentStruct)  { 
boolean  result; 
try{ 
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result  =  myNavSec . 

changeDeptInf o (myDepartment Struct)  ; 

System . out . print In 

("Query  run  successfully") ; 
return  result; 

}  catch (Exception  e) { 

System . out . print In 

("Error  in  processing  query")  ; 
return  false; 

} 

} 

If  an  exception  occurs  while  performing  the  operation,  false  value  is 
returned.  The  calling  panel  will  use  this  value  to  display  an  error  message  to  the 
client.  These  methods  are  declared  “synchronized”  in  order  to  provide  atomicity 
while  performing  the  operation. 

•  Panel  classes:  The  GUI  class  maintains  references  to  six  classes  that  extend 
the  java.swing.JPanel  class  and  have  similar  functionality  to  each  other.  These 
are  WelcomePanel,  AdminPanel,  BudgetPanel,  CommandPanel, 
OperationsPanel  and  MaintenancePanel.  Each  of  these  panel  objects  contains  a 
number  of  bean  objects  that  can  be  used  by  the  client  to  perform  a  specific 
operation.  We  will  examine  the  AdminPanel  class  as  an  example.  AdminPanel 
holds  all  of  the  panels  that  a  client  requires  for  the  insertion,  modification  or 
viewing  of  Administration  related  data  in  the  database.  These  panels  are  in  the 
form  of  bean  classes,  which  extend  the  java.swing.JPanel  class.  Figure  7.10 
shows  these  classes.  They  are  presented  to  the  client  in  a  tabular  layout.  When 
the  client  clicks  on  a  tab,  the  proper  bean  object  will  be  displayed.  The  client  can 
then  interact  with  the  bean  object  to  perform  operations  on  the  back-end 
database. 
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•  Bean  classes:  Each  bean  class  is  comprised  of  one  or  two  panels.  The 
number  of  panels  that  each  bean  class  contains  depends  on  the  operation  that  it  is 
designed  to  perform.  The  bean  classes  that  are  used  by  the  client  to  insert 
information  into  the  database  have  one  panel  to  get  user  inputs.  Other  bean 
classes  used  by  the  client  to  execute  select  queries  and  view  the  resulting 
information  have  two  panels.  One  of  these  panels  is  used  to  enter  the  parameters 
for  the  query,  the  other  is  used  to  display  the  results  returned  via  the  ORB.  All 
of  the  bean  classes  make  calls  on  the  CorbaBean  object  to  execute  the  operations. 
After  the  client  enters  the  parameters  for  the  query  and  clicks  on  the  “Submit” 
button  the  generated  event  is  captured  by  the  bean,  the  input  data  is  parsed  and 
the  corresponding  method  of  the  CorbaBean  object  is  invoked  with  the  input  data 
as  parameters.  The  following  code  shows  how  the  GetDaysDeployedBean  object 
in  the  AdminPanel  invokes  the  CorbaBean  method  to  get  information  about  the 
deployment  days  of  a  sailor: 

Navy .deployment Struct []  result  = 

parentApplet . corbaBean . getDaysDeployed 
(entrystring [0] , entrystring [1] , 
entrystring [2] , entrystring [3] ) ; 

The  results  of  the  query  are  returned  in  an  array  of  CORBA  structs.  If  an 
error  condition  occurs  while  performing  the  query,  or  the  result  set  has  no 
elements,  this  is  indicated  to  the  user  in  a  dialog  box  displayed  by  the  calling 
panel  object.  This  is  accomplished  with  the  following  code: 

if  (  result  ==  null  ) { 

JOptionPane . showMessageDialog 
(parentApplet , "Error  in  executing  query” 

, " " ,  JOptionPane . ERROR_MESSAGE  ) ; 

} 

else{ 

int  resultLength  =  result .length; 
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if (  resultLength  ==  0  ) { 

JOptionPane .  shovrfyiessageDialog 

(parentApplet, "The  query  returned  no  results" 
, " " ,  JOptionPane . INFORMATION_MESSAGE) ; 

} 


} 

After  making  these  checks  the  results  of  the  query  are  parsed  and 
displayed  by  using  an  instance  of  the  java.swing.JTable  class.  This  class  is  useful 
for  displaying  tables  of  information. 

F.  SYSTEM  OPERATION  SCENARIO 

After  installing  and  configuring  Java  and  Visibroker  ORB  on  the  machine  that 
will  host  the  CORBA  server,  the  following  steps  should  be  followed  to  provide  services 
to  clients: 


•  First,  start  the  Visibroker  OSAgent.  The  Naming  Service  uses  OSAgent 
transparently.  The  OSAgent  may  be  started  automatically  as  a  system  service  or 
by  typing  the  following  command: 

prompt>  start  osagent  -  c 

The  start  command  opens  up  a  new  window  for  execution  so  you  can  keep 
using  the  same  window  for  the  following  commands. 

•  Start  the  CORBA  Naming  Service  by  entering  the  following  command: 

prompt>  java  -DORBServices=CosNaming 
“DSVCnaTneroot=CorbaJava 
-  D  JDKr  enameBug 

com. visigenic . vbroker , services . 

CosNaming . ExtFactory 
JavaCorba  namingLog 
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•  Then  we  can  start  the  server  by  entering  the  following; 

prompt>  java  -DORBServices=CosNaming 
-DSVCnameroot=JavaCorba 
NavSecServer 

In  order  to  provide  an  Internet  accessible  interface  for  the  client,  the  following 
steps  need  to  be  taken: 

•  Install  the  HTML  files  and  the  Java  applet  classes  on  the  web  server.  The 
machine  that  hosts  the  web  server  must  have  access  to  the  ORB  classes.  This  can 
be  achieved  by  configuring  the  CLASSPATH  environment  variable  to  point  to 
the  “VisibrokerMib”  directory  or  unzipping  the  jar  files  found  in  this  directory  to 
the  directory  that  contains  client  HTML  and  Java  files. 

•  Start  the  HOP  Gatekeeper.  This  enables  the  applet  to  invoke  CORBA  servers 
that  are  on  a  different  host  than  the  web  server.  It  also  allows  firewall  traversal. 
This  is  accomplished  by  entering  the  following: 

prompt>  start  gatekeeper 

•  Enter  the  URL  for  the  CORBA  server  in  your  web  browser.  For  our  EIS 
prototype  the  URL  is  http://www.dbase-research.nps.navy.mil:  1 5000/Gui.html. 
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•  Enter  your  username  and  password.  Figure  7.1 1  displays  a  screenshot  of  the 
log  in  process. 


Figure  7.11:  Prototype  log-in  screenshot 


•  Select  the  menu  item  that  you  wish  to  view.  Figure  7.12  displays  the  applet 
switchboard. 


Figure  7.12:  Applet  switchboard 
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•  Execute  the  queries  that  you  want  to  perform.  Figure  7.13  displays  an 
example  of  a  database  query. 


HftW  SFClIRir*'  FIS  COMMAND 


'view  Command  Demograplilcs  ^Noc  ]  Vtow Command  Demopraptiica  1^ Rank  fVlowCoiiwm^  _ 

'Add  Popaftmem  [A<ldDMslon  I^Change  PiHiaftnwit  Oam  j  Chaiige  DMeion  Pato  [  View  Commatwl  Det»oqrai>hlc»  By  Gender  | 

I  GET  EMERGENCY  LIST  FOR  THE  COMIyIAND  FORM 


Elite!  rite  command  Id  and  click  mi  tiio  «uNnft  biirron 


Figure  7.13:  Sample  prototype  database  query  screenshot 

•  View  the  results  of  the  query.  Figure  7. 14  displays  an  example  of  a  query 
result  set. 


HAW  SECURHY  GROUP  BS  COMMAND 


Cotntrtand  Demograptacs  By  Hec  [View  Command  Demoflraphlce  By  Ran^  _ 

'^Add  Department  fAddOMmleii  [aianoe  Department  DfigaYciianoe  DMsJon  Commaixl  Dern^  } 


[""back  1  r  CLEAR  I  I  SUBMIT;  ]  f  CANCEL  | 

Figure  7.14:  Sample  prototype  query  result  screenshot 
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•  Exit  the  web  page  or  shut  down  the  web  browser  when  you  are  finished. 
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vni.  CONCLUSION 


A.  SYNOPSIS  AND  CONCLUSION 

With  the  ending  of  the  cold  war,  military  organizations  in  the  United  States  faced 
considerable  cuts  in  personnel,  material  and  financial  resources.  All  remaining 
organizations  were  placed  under  considerable  pressure  to  do  more  with  less.  The  ever- 
changing  nature  of  organizations  placed  the  Naval  Security  Group  in  a  situation  where  it 
had  to  manage  and  integrate  widely  dispersed  information  stores  that  resided  on  different 
hardware  and  used  different  software.  The  sharing  and  synchronization  of  such  dispersed 
data  has  become  a  burden  on  the  NSG.  Many  similar  organizations  in  the  military  and 
corporate  America  are  adapting  distributed  object  technologies  that  provide  them  with  a 
manageable,  efficient  and  cost-effective  information  infrastructure.  These  systems  are 
proven  to  be  scalable,  high  performing,  and  easy  to  implement,  manage  and  update. 

The  focus  of  this  thesis  has  been  to  design  and  implement  a  component-based 
Client/Server  system  that  makes  use  of  the  Internet  as  the  network  medium.  Component- 
based  distributed  systems  offer  lower  costs  and  shorter  development  cycles.  They 
integrate  with  existing  software,  which  enables  an  organization  to  protect  its  investments. 
The  non-proprietary  nature  of  CORBA  was  a  major  factor  in  choosing  this  new 
technology  for  our  proposed  solution.  We  believe  that  locking  an  organization  into  a 
one-vendor  solution  will  greatly  limit  that  organization’s  information  technology 
capabilities.  A  distributed  application  built  using  CORBA  gives  the  user  hardware  and 
operating  system  independence.  Organizations  can  mix  and  match  systems  according  to 
their  needs  and  features  supported  by  these  products.  The  backbone  of  om  EIS,  the 
Internet,  has  become  the  most  widely  used  medium  for  information  transfer.  Its  almost 
non-existent  cost  of  maintenance,  high  availability  and  usability  make  it  the  preferred 
method  for  implementing  distributed  architectures. 

This  thesis  has  proven  that  it  is  an  effective  solution  to  implement  an  Internet- 

based  Enterprise  Information  System  using  Commercial  Off  The  Shelf  tools.  Our 

proposed  system  uses  CORBA,  an  industry-backed,  non-proprietary,  standards-based 

distributed  architecture  and  Java,  a  new  object-oriented  high-level  language  that  enables 
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developers  to  deliver  mobile  executable  content  over  the  Internet.  We  have  found  that  a 
combination  of  these  technologies  provides  a  powerful  infrastructure  for  building 
component-based  Client/Server  systems. 

This  thesis  can  be  used  by  the  Naval  Security  Group  to  evaluate  a  number  of 
similar  commercial  products  that  have  begun  to  emerge,  or  it  can  be  used  to  further 
develop  oiu  prototype  into  a  fully  functional  EIS.  In  each  case,  the  end  result  would 
enhance  the  capabilities  of  the  organization  with  very  little  overhead  involved. 

B.  SECURITY 

Any  system  that  is  connected  to  the  Internet  is  susceptible  to  attacks.  These 
attacks  can  harm  the  confidentiality,  integrity  and  availability  of  information.  Placing  a 
firewall  between  the  Internet  and  the  CORBA  server  can  serve  as  a  first  line  of  defense 
for  our  proposed  EIS.  The  firewall  can  allow  only  packets  that  use  specific  ports  on  the 
server  machine  to  pass  through.  These  packets  need  to  be  addressed  to  the  Gatekeeper, 
which  acts  as  a  proxy  between  the  server  implementation  and  the  client  applet.  A  buffer 
zone  can  be  created  with  the  addition  of  yet  another  firewall  between  the  Gatekeeper  and 
the  CORBA  server.  Such  a  configuration  would  make  it  even  harder  for  an  intruder  to 
break  in. 

Even  if  all  of  the  servers  are  protected  from  intrusion  by  the  use  of  firewalls,  it  is 
impossible  to  ensure  the  confidentiality  of  packets  that  traverse  the  Internet  without  the 
use  of  an  encryption  package.  Since  the  Internet  was  designed  as  an  open  medium  with 
no  security  considerations,  it  is  possible  to  view  the  contents  of  any  packet  with  use  of  a 
simple  packet  sniffer  program.  The  OMG  provides  a  standard  for  using  HOP  over  the 
Secure  Socket  Layer  (SSL)  protocol.  SSL  allows  users  of  the  system  to  encrypt  the 
information  before  it  is  sent  over  the  Internet.  It  also  supplies  the  means  to  identify  and 
authenticate  each  side  of  a  data  exchange.  This  is  extremely  important,  as  it  is  possible  to 
fake  one’s  identity  utilizing  IP  spoofing  methods.  OMG  certificates  authenticate  each 
user  in  the  SSL  system.  Each  certificate  contains  the  name  of  the  holder  and  a  value.  The 
certificates  must  be  verified  by  a  trustworthy  authority  in  order  to  be  considered 
authentic.  There  are  various  firms  that  specialize  in  the  generation  and  distribution  of 

authentic  certificates.  When  the  client  and  the  server  establish  a  connection  over  a  SSL 
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they  exchange  their  certificates.  The  certificates  can  then  be  used  to  verify  the  identity  of 
the  party  in  an  exchange.  In  order  to  use  the  Visibroker  SSL,  both  the  client  and  the 
server  must  use  SSL  Version  3.0.  If  these  capabilities  are  not  considered  secure  enough 
for  the  EIS,  the  system  can  be  implemented  on  a  more  secure  Intranet. 

C.  AREAS  FOR  FURTHER  RESEARCH 

In  our  implementation  we  used  a  basic  object  dispenser  that  depends  on  the  server 
platform  for  scaling  and  load  balancing.  In  a  real  world  solution  a  Transaction 
Processing  (TP)  monitor  would  be  required  to  handle  all  of  the  server  objects  and 
connections  with  clients.  A  commercial  off  the  shelf  TP  monitor  could  be  purchased  to 
provide  scalability  to  the  EIS.  The  Visibroker  SSL  package  can  also  be  purchased  to 
provide  security  for  Internet-based  communications.  Since  our  major  research  question 
did  not  cover  the  usability  of  the  interface,  the  user  interface  has  been  designed  only  to 
provide  basic  functionality.  It  can  be  further  enhanced  to  provide  error  detection  and 
correction  and  the  functionality  can  be  increased  through  the  use  of  different  widgets  that 
can  be  foxind  in  the  java.swing  package  or  different  GUI  builder  tools  such  as  Jbuilder2 
and  VisualCafeS.O.  A  GUI-based  tool  can  be  developed  to  provide  the  server  manager 
with  the  capability  to  monitor  the  system  fi:om  any  location  over  the  Internet  by  the  use  of 
a  web  browser.  Different  implementations  that  make  use  of  the  competing  component 
technologies,  such  as  Remote  Method  Invocation  (RMI)  and  Distributed  Component 
Object  Model  (DCOM),  can  be  built  and  benchmarked  to  show  a  comparison  of  the 
performance  and  scalability  of  these  different  distributed  architectures.  The  use  of 
applets  places  severe  limitations  on  the  capabilities  of  the  user  interface.  For  example, 
the  user  cannot  store  the  results  of  a  query  on  his  hard  disk.  These  limitations  can  be 
relaxed  with  the  use  of  die  new  security  model  in  JDKl.l,  which  uses  certificates  to 
authenticate  the  source  of  the  applet  and  then  grants  permissions  to  the  applet  in 
accordance  with  the  user  defined  security  policy  on  the  client  system.  JDK1.2  will  > 
enhance  the  granularity  of  this  security  model.  An  implementation  with  JDK1.2  and 
CORE  A  3.0  can  be  developed  to  investigate  such  enhancements.  Finally,  the  system 
front-end  can  be  built  as  an  application  instead  of  an  applet.  This  would  mean  sacrificing 

the  automatic  upgrade  feature  of  the  system,  but  with  the  installation  of  the  ORB  locally 
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on  the  client,  the  penalty  of  having  to  download  the  ORB  everytime  the  user  needs  access 
to  the  system  would  be  avoided.  The  use  of  callbacks  by  the  CORE  A  server  objects 
enables  updating  the  state  of  the  applet  front-end  when  the  data  queried  by  the  applet 
changes  after  the  query  has  been  executed.  This  brings  rapid  response  to  the  changes  that 
occur  almost  every  second.  For  example,  the  user  may  run  a  query  to  determine  the 
number  of  missions  flown  in  a  specific  area.  There  might  be  two  more  missions  added  to 
the  database  by  the  time  the  user  has  observed  the  query  results.  By  using  callbacks  the 
CORBA  server  can  update  the  results  of  the  query  while  the  user  is  viewing  them.  The 
EIS  model  implemented  in  this  thesis  can  be  expanded  to  cover  and  evaluate  the  use  of 
callbacks  by  the  server  objects.  Finally,  implementations  that  make  use  of  Message 
Oriented  Middleware  (MOM)  can  be  built  for  evaluation.  Message  oriented  middleware 
enable  asynchronous  messages  to  be  exchanged  between  the  server  and  the  client.  They 
can  be  used  in  environments  where  the  client  and  server  will  not  be  operable  all  the  time. 
For  example  the  client  can  be  hosted  by  a  mobile  unit  that  has  sporadic  access  to  the  EIS. 
This  will  expand  the  usable  environment  of  the  EIS  from  stationery  locations  to  mobile 
units  with  an  Internet  connection. 
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APPENDIX  A.  UML  NOTATION  REFERENCE  TABLE 


REPRESENTATION  IN  DIAGRAM 


EXPLANATION 


UML  Notation  for  an  actor 


UML  Notation  for  a  use  case 


UML  Notation  for  a  class 


UML  Notation  for  a  package 


UML  Notation  for  an  object 


Method  Name(parameter) 


UML  Notation  for  a  message  between 
objects 


UML  Notation  for  an  association 
relationship 


UML  Notation  for  an  aggregation 
relationship 


UML  Notation  for  displaying  role  names 


UML  Notation  for  displaying  a  multiplicity 
indicators 


Sub  class 

w 

Super  class 

W 

UML  Notation  for  displaying  a  inheritance 
relationship 


Main  class 

-  _  ^ 

- ^ 

cla« 

UML  Notation  for  displaying  a  dependency 
relationship 


Sub  class 

A  ^ 

Super  class 

\/  ^ 

UML  Notation  for  displaying  a 
unidirectional  association  relationship 


UML  Notation  for  package  relationships 
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APPENDIX  B.  NAVSEC.IDL  FILE 


This  file  is  used  by  the  idl2java  compiler  to  create  the  server  skeleton  and  client 
stub  files.  IDL  files  act  as  a  contract  between  the  server  and  potential  clients. 


// - 

//  Filename 
//  Authors 
//  Date 
//  Compiler 
// - 


NavSec . idl 

Murat  Akbay  &  Steve  Lewis 
10/13/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


module  Navy 
{ 


exception  navsecException 
{string  reason; 

}; 


struct  adressStruct 

{ 

string  adress; 
string  city; 
string  state; 
string  country; 
string  postalCode; 
string  homePhone; 
string  ssn; 

}; 

typedef  sequence<adressStruct>  adressSeq; 

struct  familyStruct 

{ 

string  ssn; 
string  name; 
string  sdate; 
string  sex; 
string  sailorSsn; 

}; 

typedef  sequence< familyStruct >  familySeq; 

struct  familydescStruct 

{ 

string  rank; 
string  firstName; 
string  lastName; 
string  memberSsn; 
string  memberName; 
string  memberBirth; 
string  memberSex; 
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.  string  ememberSailorSsn; 

}; 

typedef  sequence<familydescStruct>  familydescSeq; 

struct  spouses truct 

{ 

string  ssn; 
string  name; 
string  bdate; 
string  gender; 
string  sailorSsn; 
string  update; 


}; 

typedef  sequence<spouseStruct>  spouseSeq; 


struct  spousedescStruct 

{ 

string  rank; 
string  firstName; 
string  lastName; 
string  spouseSsn; 
string  spouseName; 
string  spouseBirth; 
string  spouseSex; 
string  SailorSsn; 

}; 

typedef  sequence<spousedescStruct>  spousedescSeq; 


struct  prtStruct 

{ 

string  commandid; 
string  identifier; 
string  height; 
string  weight; 
string  pushups; 
string  sitUps; 
string  runTime; 
string  pdate; 
string  status; 
string  ssn; 

}; 

typedef  sequence<prtStruct>  prtSeq; 


struct  prtdescStruct 

{ 

String  rank; 
string  firstName; 
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string  lastName; 
string  commandid; 
string  prtid; 
string  prtSsn; 
string  height; 
string  weight; 
string  pushUps; 
string  sitUps; 
string  runTime; 
string  prtDate; 
string  status; 

}; 

typedef  sequence<prtdescSt2nict>  prtdescSeq; 


struct  leaveStruct 

{ 

string  commandid; 
string  leaveControlNumber; 
string  typeOf Leaver- 
string  departDate; 
string  returnDate; 
string  ssn; 

}; 

typedef  sequence<leaveStruct>  leaveSeq; 


,  struct  leavedescStruct • 

{ 

string  rank; 
string  firstName; 
string  lastName; 
string  leaves  sub¬ 
string  controlNumber; 
string  typeOf Leaver¬ 
string  dateDepart; 
string  dateReturn; 

}; 

typedef  sequence<leavedescStruct>  leavedescSeq; 


struct  necStruct 

{ 

string  primaryNec; 
string  secondaryNec; 
string  tertiaryNec; 
string  lastDate; 
string  ssn; 

}; 

typedef  sequence<necStruct>  necSeq; 
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struct  property's truct 

{ 

string  propertyld; 
string  propertyDesc; 
string  purchaseDate; 
string  price; 
string  commandid; 
string  purchaser ; 
string  sqlDate; 
string  purchaseCategory; 

}; 

typedef  sequence<propertyStruct>  propertySeq; 


struct  departments truct 

{ 

String  commandid; 
string  department Id; 

String  title; 
string  headSsn; 
string  chiefSsn; 
string  telephone; 
string  email; 

}; 

typedef  sequence<departmentStruct>  departmentSeg; 


struct  divisions truct 

{ 

string  commandid; 
string  department Id; 
string  divisionid; 
string  title; 
string  headSsn; 
string  chiefSsn; 
string  telephone; 
string  email; 

}; 

typedef  sequence<divisionStruct>  divisionSeq; 


struct  maintenanceStruct 


{ 


string  persona- 
string  maintenanceNumber; 
string  itemid; 
string  pmsNumber; 
string  da t eOf Conduct; 
string  priority; 
string  emDescription; 
string  commandid; 
string  department Id; 
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string  divisionid; 
string  hoursOnJob; 

}; 

typedef  sequence<maintenanceStruct>  maintenanceSeq; 

struct  sailorStruct 

{ 

string  s sub¬ 
string  firstName; 
string  middleName; 
string  lastName; 
string  sex; 
string  rankRate; 
string  dateOfRank; 
string  devicelb¬ 
string  device2; 
string  devices ; 
string  primaryNec; 
string  secondaryNec; 
string  tertiaryNec; 
string  address; 
string  city; 
string  state; 
string  country; 
string  postalCode; 
string  homePhone; 
string  dateOfBirth; 
string  dateOf Service; 
string  homeTown; 
string  homeState; 
string  dateOf Update ; 

}/• 

typedef  sequence<sailorStmct>  sailorSeq; 


struct  seamissionStruct 

{ 

string  missionNumber; 
string  dateOfMission; 
string  typeOf Mission ,- 
string  exerciseName; 
string  platformMode; 
string  platf ormType ; 
string  platformNumber ; 
string  platf ormName; 
string  missionArea; 

}; 

typedef  sequence<seaTnissionStruct>  seamissionSeq; 


struct  airmissionStruct 

{ 

string  missionNumber; 
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string  takeOf fTime; 
string  landingTime; 
string  duration; 
string  platformNumber ; 
string  squadron; 
string  squadronCrew; 
string  base; 
string  city; 
string  country; 
string  typeMission; 
string  platformType; 
string  exerciseName; 
string  missionArea; 
string  trackid; 

}; 

typedef  sequence<airmissionStruct>  airmissionSeq; 


struct  deploymentStruct 

{ 

string  tangoNumber ; 
string  dateDepart; 
string  rankRate; 
string  firstName; 
string  lastName; 
string  commandName ; . 
string  title; 
string  dateArrival; 
string  dateDeparture ; 
string  comm; 

}; 

typedef  sequence<deploymentStruct>  deploymentSeq; 


struct  propertydescStruct 

{ 

string  commandName; 
string  propertyld; 
string  propertyDesc; 
string  dateOf Purchase; 
string  price; 
string  rank; 
string  firstName; 
string  lastName; 

}; 

typedef  sequence<propertydescStruct>  propertydescSeq; 


struct  demographicStruct 

{ 

string  commandName; 
string  number; 
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string  datex; 

}; 

typedef  sequence<demographicStruct>  demographicSeq; 


struct  emergencyStruct 

{ 

string  commandName ; 
string  deptid; 
string  rank; 
string  firstNarae; 
string  lastName; 
string  homePhone; 

}; 

typedef  seguence<emergencyStruct>  emergencySeq; 


struct  seamissiondescStruct 

{ 

string  missionNumber; 
string  dateOf Mission ; 
string  typeOfMission; 
string  exerName; 
string  platformMode; 
string  platformType; 
string  platfortnNumber; 
string  platformName; 
string  missionAreald; 
string  description; 

}; 

typedef  sequence<seaTnissiondescStruct>  seamissiondescSeq 


struct  airmissiondescStruct 

{ 

string  missionNumber; 
string  dateTakeOff; 
string  dateLanding; 
string  duration; 
string  platformType; 
string  platformNuraber ; 
string  squadronid; 
string  squadronCrew; 
string  stageBase; 
string  stageCity; 
string  stageCountry; 
string  typeOfMission; 
string  exerName; 
string  missionAreald; 
string  trackid; 
string  description; 

}; 
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typedef  sequence<airmissiondescStruct>  airmissiondescSeg; 


struct  commaintenanceStruct 

{ 

string  commandid; 
string  description; 
string  persona- 
string  itemid; 
string  maintNo/ 
string  dateConduct; 
string  priority; 
string  emergencyDesc; 
string  dept Id; 
string  hours; 

}; 

typedef  sequence<commaintenanceStruct>  commaintenanceSeq; 


struct  itemmaintenanceStruct 

{ 

string  pmsDesc; 
string  description; 
string  persona- 
string  itemid ; 
string  maintNo ; 
string  dateConduct; 
string  priority; 
string  emergencyDesc; 
string  dept Id ; 
string  hours; 

}/• 

typedef  sequence<itemmaintenanceStruct>  itemmaintenanceSeg; 


interface  NavSec 
{ 

boolean 

boolean 

boolean 

boolean 

boolean 

boolean 

boolean 

boolean 

boolean 

boolean 

boolean 

boolean 


addAdress(in  adressStruct  adressData) ; 
addFamily{in  familyStruct  familyData) ; 
addSpouse(in  spouseStruct  spouseData) ; 
addPrt(in  prtStruct  prtData) ; 
addLeave(in  leaves truct  leaveData) ; 
addNec(in  necS truct  necData) ; 
addProperty (in  propertyStruct  propertyData) ; 
addDepartment  ( in  departmentStruct 
departmentData) ; 

addDivision (in  divisionStruct  divisionData); 
addMaintLog (in  maintenanceStruct 
maintenanceData) ; 

addSailor(in  sailorStruct  sailorData) ; 
addSeaMission (in  seamissionStruct 
seamissionData) ; 
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boolean 


boolean 

boolean 

boolean 

familydescSeq 

spousedescStruct 

leavedescSeq 

prtdescSeq 

deploymentSeq 

propertydescSeq 
demographic  S  e  q 

demogr aphi c S e q 

demographicSeq 

emergencySeq 

seamissiondescSeq 


seamissiondescSeq 

seamissiondescSeq 

s  eami s  s i ondes  c S eq 

seamissiondescSeq 


addAirMission (in  airmissionStruct 
airmissionData) ; 

changeDeptInfo (in  departmentStruct 
departmentData) ; 

changeDivisionInfo (in  divisionStruct 
divisionData) ; 

getAuthorization(in  string  userName, 
in  string  password) ; 

getFamilyMembers (in  string  sailorSsn,  in 
string  lastName) ; 

getSpouse(in  string  sailorSsn,  in  string 
lastName) ; 

getLeaveData (in  string  sailorSsn,  in  string 
lastName) ; 

getPrtResults (in  string  sailorSsn,  in  string 
lastName)  ; 

getDaysDeployeddn  string  sailorSsn,  in  string 
lastName, 

in  string  startDate,  in  string 
stopDate) ; 

getPropertyList (in  string  commandid); 

getComDemByGender (in  string  commandid, 
in  string  sex) ; 

getComDemByNec (in  string  commandid, 

in  string  necl,  in  string  nec2, 
in  string  nec3) ; 

getComDemByRank (in  string  sailorSsn, 
in  string  paygrade) ; 

getEmergencyList (in  string  commandid); 

getSeaMissions (in  string  platfrom, 

in  string  typeMission, 
in  string  missionArea, 
in  string  startDate, 
in  string  stopDate) ; 


getSeaMissionsByPlatform(in  string  platform, 

in  string  startDate, 
in  string  stopDate) ; 

getSeaMissionsByArea (in  string  missionArea, 

in  string  startDate, 
in  string  stopDate) ; 

getSeaMissionsByType(in  string  typeMission, 

in  string  startDate, 
in  string  stopDate) ; 

getSeaMissionsByExercise (in  string 

exerciseName, 
in  string  startDate, 
in  string  stopDate) ; 
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seamissiondescSeg 


airmissiondescSeq 


airmissiondescSeq 


airmissiondescSeq 


airmissiondescSeq 


airmissiondescSeq 


airmissiondescSeq 


commaintenanceSeq 


itemmaintenanceSeq 

}; 


getSeaMissionsByPlatformName (in  string 

platform, 
in  string 

startDate, 
in  string 

stopDate) ; 

getAirMissions (in  string  squadron, 
in  string  platform, 
in  string  typeMission, 
in  string  missionArea, 
in  string  startDate, 
in  string  stopDate) ; 

getAirMisByPlatformNo (in  string  platform, 

in  string  startDate, 
in  string  stopDate) ; 

getAirMisByArea  (in  string  missionArea, 
in  string  startDate, 
in  string  stopDate) ; 

getAirMisByType  (in  string  typeOfMission, 
in  string  startDate, 
in  string  stopDate) ; 

getAirMisByExercise (in  string  exerciseName, 

in  string  startDate, 
in  string  stopDate) ; 

getAirMisBySquadron (in  string  squadronName , 

in  string  startDate, 
in  string  stopDate) ; 

getMaintByCommand (in  string  commandid, 

in  string  department Id, 
in  string  startDate, 
in  string  stopDate) ; 

getMaintByltem (in  string  itemid) ; 


interface  NavSecDispenser 

{ 

NavSec  reserveNavSecObject ( )  raises  (navsecException)  ; 
void  releaseNavSecObject (in  NavSec  navsecObject) 

raises  (navsecException) ; 

}; 

}; 
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APPENDIX  C.  SERVER  FILES 


This  appendix  provides  all  the  source  code  required  for  the  Server 
implementation.  It  includes  the  NavSecServer.java,  NavSecDispenserImpl.java, 
NavSecImpl.java,  and  DBHelper.java  classes. 


// . . 

//  Filename 
//  Authors 
//  Date 
//  Compiler 
// - 


NavSecServer . j  ava 

Murat  Akbay  &  Steve  Lewis 

10/13/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


/** 

*  Main  driver  class  for  NavSecServer,  server  component  of  the  NavSec 

*  EIS  Prototype 

* 

*  ©authors  Murat  Akbay  &  Steve  Lewis 
*/ 


import  org . omg . CosNaming . * ; 
import  j  ava . ut il . * ; 


class  NavSecServer { 

static  public  void  main (String []  args) { 
int  noOf Instances; 
try{ 

if  (args. length  ==  0)  { 
noOf Instances  =  3; 

} 

else{ 

noOf Instances  =  Integer .parseint (args  [0] ) ; 

} 


//  Initialize  the  ORB 

org .  omg .  CORBA .  ORB  orb  =  org .  omg .  CORBA .  ORB .  ini  t  ( args ,  nul  1 )  ; 


//  Create  the  ClubMedDispenser  object 
NavSecDispenserlmpl  mydispenser  = 

new  NavSecDispenserlmpl  (args,  "My  Dispenser", 

noOf Instances) ; 

//  Export  the  newly  created  object 
orb . connect (mydispenser) ; 
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System . out . print In ( "Dispenser  created . . " ) ; 

//  Get  a  reference  to  the  Naming  service 
org . omg . CORBA . Ob j  ect  nameServiceOb j  = 

orb. resolve_initial_ref erences  ( "NameService" )  ; 

if  (nameServiceOb j  ==  null) 

{ 

System. out .print In ("nameServiceOb j  =  null") ; 
return; 

} 

org . omg . CosNaming . NamingContext  nameService  = 
org .  omg .  CosNaming .  NamingContextHelper .  narrow  (nameServiceOb  j  )  ; 

if  (nameService  ==  null) 

{ 

System. out .println( "nameService  =  null") ; 
return; 

} 

//  bind  the  NavSec  object  in  the  Naming  service 
NameComponent  []  mydispensemame  =  {new  NameComponent 

( "NavSecDispenser " ,”")}; 

nameService .  rebind  (mydispensemame ,  mydispenser )  ; 

System. out. print In ("Server  is  ready  ..."); 

//  wait  forever  for  current  thread  to  die 
Thread . currentThread ( )  . j  oin ( ) ; 

}  catch (Exception  e) { 

System. err. print In (e) ; 

} 

} 

}//  End  NavSecServer . java 
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// - 

//  Filename 
//  Author 
//  Date 
//  Compiler 
// - 

/** 


NavSecDispenserlmpl .java 
Murat  Akbay  &  Steve  Lewis 
10/13/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


*  This  class  is  the  object  factory  that  creates  NavSec  objects,  the 

*  number  of  NavSec  Objects  is  determined  by  the  number  of  arguments 

*  passed  to  the  constructor 

* 


*  ©author  Murat  Akbay  &  Steve  Lewis 
*/ 


public  class  NavSecDispenserlmpl  extends  Navy ._NavSecDispenserImplBase{ 

private  int  maxObjects  =  10; 
private  int  numObjects  =  0; 

private  NavSecStatus  []  navSec  =  new  NavSecStatus  [maxObjects]; 


/** 

*  Constructor  for  the  class 

* 

*  ©param  args  ORB  initialization  parameter 

*  name  Name  used  to  define  the  instance  of  this 

*  class 

*  number  The  number  of  NavSec  instances  desired 

*  ©return  an  instance  of  the  class 

*  ©exception  none 
*/ 

piiblic  NavSecDispenserlmpl  ( java,  lang.  St  ring  []  args, 

j ava . lang . String  name ,  int  number) { 


super (name) ; 
try{ 

//  get  reference  to  orb 

org.omg.  CORBA.ORB  orb  =  org.omg. CORBA. ORB .  ini t  (args ,  null)  ; 

//  prestart  n  navSec  Objects 
numObjects  =  number; 

for  (int  ix  =  0;  ix  <  numObjects;  ix++) { 
navSec  [ix]  =  new  NavSecStatusO; 

navSec  [ix]  .ref  =  new  NavSecImpl  ( "NavSec”  +  (ix+1)); 
orb. connect (navSec [ix] .ref) ; 

System. out .println( "NavSec "+  (ix+l)+  "is  ready"); 


} 
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} 

catch (Exception  e) { 

System. err. println(e) ; 

} 


} 


/*★ 

*  Default  constructor  for 

•it 

the  class 

*  ©param 

none 

*  ©return 

an  instance 

of  the  class 

*  ©exception 

none 

*/ 

piAblic  NavSecDispenserlmpl  {)  { 


super { )  ; 

} 


/** 

*  This  method  is  used  by  the  client  to  reserve  NavSec  Objects,  when 

*  the  NavSec  object  is  reserved  it  can  not  be  assigned  to  any  other 

*  client 

* 

*  ©param  none 

*  ©return  a  reference  to  an  instance  of  NavSec  class 

*  ©exception  none 
*/ 

public  Navy. NavSec  reserveNavSecObject (  ) 

throws  Navy. navsecExcept ion { 


for  (int  ix  =  0;  ix  <  numObjects;  ix++) 

{ 

if  (lnavSec[ix] .inUse) { 

navSec [ix] . inUse  =  true; 

System . out . println ( "NavSec "  +  { ix+1 ) 
return  navSec [ix] .ref; 


} 


} 


+ 


reserved. " ) ; 


return  null; 

} 
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/** 

*  This  method  is  used  by  the  client  to  release  a  NavSec  object 

*  when  it  finishes  using  the  object.  The  released  object  can  be 

*  assigned  to  another  client  for  use. 

* 

*  ©param  NavSec  Reference  to  the  NavSec  object  that  the  client  uses 

*  ©return  none 

*  ©exception  none 
*/ 

public  void  releaseNavSecObject  (Navy. NavSec  navsecObj  ect) 

throws  Navy .navsecExcept ion 

{ 

org.omg.CORBA. Object  inelement  =: 

(org .  omg .  CORBA .  Ob j  ect)  navsecObj  ect  ; 
for  (int  ix  =  0;  ix  <  numObjects;  ix++) { 
org. omg. CORBA. Object  element  = 

(org. omg. CORBA. Object)  navSec[ix]  .ref; 

if  ( element.  _is_eguivalent  (inelement)  )  { 
navSec [ix] . inUse  =  false; 

System. out. print In ("NavSec”  +  (ix+1)  +  ”  released.”); 
return  ; 

} 

} 

System.out.println( "Reserved  Object  not  found”); 
return  ; 

} 

}//  End  NavSecDispenserImpl. java 


/** 

*  This  class  is  used  by  the  NavSecDispenserImpl  to  keep 

*  track  of  the  status  of  the  NavSec  objects. 

* 

*  ©author  Murat  Akbay  &  Steve  Lewis 
*/ 

class  NavSecStatus{ 

NavSecImpl  ref; 
boolean  inUse; 

NavSecStatus () { 
ref  =  null; 
inUse  =  false; 

} 

} //  End  NavSecStatus . j ava 
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//---- . 

//  Filename 
//  Author 
//  Date 
//  Compiler 
// - 


NavSecImpl . java 

Murat  Akbay  &  Steve  Lewis 

10/14/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


*  This  class  is  the  server  object  that  answers  the  requests  made  by 

*  the  client.  It  does  this  by  making  method  calls  on  the  local 

*  DBHelper  object 

* 

*  ©author  Murat  Akbay  &  Steve  Lewis 
*/ 


import  java.util.*; 

public  class  NavSecImpl  extends  Navy ._NavSecImplBase 

{ 

private  DBHelper  myDBHelper; 
private  String  instanceName; 

/** 

*  Constructor  for  the  class 

* 

*  ©param  name  Name  used  to  define  the  instance  of  this  class 

*  ©return  none 

*  ©exception  none 
*/ 

public  NavSecImpl (java . lang. String  name)  { 
super (name) ; 
try  { 

myDBHelper  =  new  DBHelper ( ) ; 

myDBHelper . connect ("131.120.3.4”,  "NSGDB " ,  " sa " ,  " " ) ; 

System. out .println ( "DBHelper  Object  "  +  name  +  "  Created"); 
instanceName  =  name; 

}  catch  (Exception  e) { 

System. out .println ("System  Exception  ") ; 

} 

} 


/** 

*  Default  constructor  for  the  class 


* 

*  ©param 

none 

*  ©return 

none 

*  ©exception 

none 

*/ 

p\iblic  NavSecImpl  0  { 
‘  super  ( ) ; 


} 
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I'k'k 

*  This  method  is  used  by  the  client  to  modify  the  address  of  a 

*  sailor  in  the  database 

* 

*  ©param  addressData  The  struct  that  holds  the  address 

*  information 

*  ©return  boolean  true  or  false 

*  ©exception  none 
*/ 

public  boolean  addAdress (Navy .adressStruct  adressData  ){ 
try  { 

return  myDBHelper .addAdress (adressData) ; 

}  catch  (Exception  e) { 

System. out. printlnC'System  Exception  in  addAdress"); 
return  false; 

} 

} 


/** 

*  This  method  is  used  by  the  client  to  add  family  members 

*  to  the  database 

* 

*  ©param  familyData  The  struct  that  holds  family  information 

*  ©return  boolean  true  or  false 

*  ©exception  none 
*/  ’ 

ptiblic  boolean  addFamily (Navy.familyStruct  familyData  ){ 
try  { 

return  myDBHelper .addFamily (familyData) ; 

}  catch  (Exception  e) { 

System. out .printlnC'System  Exception  in  addFamily"); 
return  false; 

} 

} 


/** 

*  This  method  is  used  by  the  client  to  add  spouse  data 

*  to  the  database 

* 

*  ©param  spouseData  The  struct  that  holds  spouse  information 

*  ©return  boolean  true  or  false 

*  ©exception  none 
*/ 

public  boolean  addSpouse (Navy . spouseStruct  spouseData  ){ 
try  { 

return  myDBHelper .addSpouse s (spouseData) ; 

}  catch  (Exception  e) { 

System,  out  .printlnC'System  Exception  in  addSpouses")  ; 
return  false; 

} 
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} 


/** 

*  This  method  is  used  by  the  client  to  add  PRT  data 

*  to  the  database 

* 

*  ©pararn  prtData  The  struct  that  holds  PRT  information 

*  ©return  boolean  true  or  false 

*  ©exception  none 
*/ 

public  boolean  addPrt (Navy .prtStruct  prtData  ){ 
try  { 

return  myDBHelper.addPrt (prtData) ; 

}  catch  (Exception  e) { 

System. out .println( "System  Exception  in  addPrt") / 
return  false; 

} 

} 


/** 

*  This  method  is  used  by  the  client  to  add  leave  data 

*  to  the  database 

* 

*  ©param  leaveData  The  struct  that  holds  leave  information 

*  ©return  boolean  true  or  false 

*  ©exception  none  . 

*/ 

public  boolean  addLeave (Navy . leaveStruct  leaveData  ){ 
try  { 

•  return  myDBHelper .addLeave (leaveData) ; 

}  catch  (Exception  e) { 

System. out .print In ("System  Exception  in  addLeave"); 
return  false; 

} 

} 


/** 

*  This  method  is  used  by  the  client  to  add  nec  data 

*  to  the  database 

* 

*  ©param  necData  The  struct  that  holds  nec  information 

*  ©return  boolean  true  or  false 

*  ©exception  none  . 

*/ 

public  boolean  addNec (Navy .necStruct  necData  ){ 
try  { 

return  myDBHelper .addNec (necData) ; 

}  catch  (Exception  e) { 

System. out .print In ( "System  Exception  in  addNec"); 
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return  false; 

} 

} 

f-k-k 

*  This  method  is  used  by  the  client  to  add  command  property  data 

*  to  the  database 


* 

*  ©param 

propertyData  The  struct  that  holds  property 

* 

information 

*  ©return 

boolean  true  or  false 

*  ©exception 

none 

*/ 

public  boolean  addProperty  (Navy  .propertyS true t  propertyData  )  { 
try  { 

return  myDBHelper.addProperty (propertyData) ; 

}  catch  (Exception  e) { 

,  System. out. println( "System  Exception  in  addProperty")  ; 
return  false; 

} 

} 


/*★ 

*  This  method  is  used  by  the  client  to  add  department  data 
*■  to  the  database 

* 

*  ©param  departmentData  The  struct  that  holds  department 

*  information 

*  ©return  boolean  true  or  false 

*  ©exception  none 
*/ 

public  boolean  addDepartment  (Navy .departments truct  departmentData  ){ 
try  { 

return  myDBHelper .addDepartment (departmentData) ; 

}  catch  (Exception  e) { 

System.out.println( "System  Exception  in  addDepartment"); 
return  false; 

} 

} 


y  *  * 

*  This  method  is  used  by  the  client  to  add  division  data 

*  to  the  database 

* 

*  ©param  divisionData  The  struct  that  holds  division 

*  information 

*  ©return  boolean  true  or  false 

*  ©exception  none 
*/ 

piiblic  boolean  addDivision(Navy.divisionStruct  divisionData  )  { 
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try  { 

return  myDBHelper .addDivision(divisionData) ; 

}  catch  (Exception  e) { 

System.out.println( "System  Exception  in  addDivision”) ; 
return  false; 

} 

} 


*  This  method  is  used  by  the  client  to  add  maintenance  data 

*  to  the  database 

* 

*  ©param  maintenanceData  The  struct  that  holds  maintenance 

*  information 

*  ©return  boolean  true  or  false 

*  ©exception  none 
*/ 

public  boolean  addMaintLog (Navy .maintenances true t  maintenanceData  ){ 
try  { 

return  myDBHelper  .addMaintLog  (maintenanceData)  ; 

}  catch  (Exception  e) { 

System. out .println ( "System  Exception  in  addMaintLog") ; 
return  false; 

} 

} 


f-k-k 

*  This  method  is  used  by  the  client  to  add  sailor  data 

*  to  the  database 

* 

*  ©param  sailorData  The  struct  that  holds  sailor  information 

*  ©return  boolean  true  or  false 

*  ©exception  none 
*/ 

public  boolean  addSailor (Navy . sailorStruct  sailorData  ){ 
try  { 

return  myDBHelper .addSailor (sailorData) ; 

}  catch  (Exception  e) { 

System.out .println ("System  Exception  in  addSailor"); 
return  false; 

} 

} 
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/** 

*  This  method  is  used  by  the  client  to  add  sea  mission  data 

*  to  the  database 

* 

*  ©param  seamissionData  The  struct  that  holds  sea  mission 

*  information 

*  ©return  boolean  true  or  false 

*  ©exception  none 
*/ 

public  boolean  addSeaMission  (Navy .  seamissionStruct  seamissionData  ){ 
try  { 

return  myDBHelper. addSeaMission (seamissionData) ; 

}  catch  (Exception  e) { 

System.out.println( "System  Exception  in  addSeaMission" )  ; 
return  false; 

} 

} 


/** 

*  This  method  is  used  by  the  client  to  add  air  mission  data 

*  to  the  database 

* 

*  ©param  airmissionData  The  struct  that  holds  air  mission 

*  information 

*  ©return  boolean  true  or  false 

*  ©exception  none 
*/ 

public  boolean  addAirMission  (Navy.  airmissionS true t  airmissionData)  { 
try  { 

return  myDBHelper.  addAirMission  (airmissionData)  ; 

}  catch  (Exception  e) { 

System. out .println( "System  Exception  in  addAirMission"); 
return  false; 

} 

} 


*  This  method  is  used  by  the  client  to  add  department  data 

*  to  the  database 

* 

*  ©param  departmentData  The  struct  that  holds  department 

*  information 

*  ©return  boolean  true  or  false 

*  ©exception  none 
*/ 

public  boolean  changeDeptInfo (Navy . departmentStruct  departmentData) 

{ 

try  { 

return  myDBHelper .  changeDeptInfo  (departmentData)  ; 

}  catch  (Exception  e)  { 
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} 


System.out.println( "System  Exception  in  changeDeptInfo")  ; 
return  false; 


} 


/*-k 

*  This  method  is  used  by  the  client  to  add  division  data 

*  to  the  database 

* 

*  ©param  divisionData  The  struct  that  holds  division 

*  information 

*  ©return  boolean  true  or  false 

*  ©exception  none 
*/ 

public  boolean  changeDivisionInfo (Navy.divisionStruct  divisionData) 

{ 

try  { 

return  myDBHelper.addDivision (divisionData) ; 

}  catch  (Exception  e) { 

System. out .print In ( "System  Exception  in  changeDivisionInfo")  ; 
return  false; 

} 

} 


*  This  method 

* 

is  used  by  the  client  to  log  onto  the  database 

*  ©param 

String  userName 

*  ©param 

String  password 

*  ©return 

boolean  true  or  false 

*  ©exception 

none 

*/ 

public  boolean  get Authorizat ion (java.lang. String  userName, 

java. lang. String  password) { 

boolean  result  =  false; 
try{ 

result  =  myDBHelper .getAuthorization (userName,  password); 
return  result; 

}  catch  (Exception  ex) { 

System. out .println( "System  Exception  in  getAuthorization”) ; 
return  false; 

} 

} 
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J-k-k 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  family  members  of  a  sailor 

* 


*  ©param  sailorSsn  Social  security  number  of  the  sailor 

*  ©param  lastName  Last  Name  of  the  sailor 

*  ©return  struct  that  contains  information  about  the  family 

*  members  of  the  sailor 

* .  ©exception  none 

*/ 

public  Navy.familydescStruct  []  getFamilyMembers  (java. lang. String 

sailorSsn, 

j  ava . lang . String 

lastName) 

{ 

try  { 


Navy,  familydescStruct  []  familyData; 

Vector  families  = 

myDBHelper. getFamilyMembers  (sailorSsn,  lastName)  ; 
familyData  =  new  Navy .  familydescStruct  [families ,  size  ()]  ; 
families  .  copyinto  (familyData)  ; 
return  (familyData)  ; 

}  catch  (Exception  e) { 

System.out.println( "System  Exception  in  getFamilyMembers”); 
return  null ; 

} 

} 


/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  spouse  of  a  sailor 

* 

*  ©param  sailorSsn  Social  security  number  of  the  sailor 

*  ©pararn  lastName  Last  Name  of  the  sailor 

*  ©return  struct  that  contains  information  about  the 

*  spouse  of  the  sailor 

*  ©exception  none 
*/ 

public  Navy.spousedescStruct  getSpouse (  java. lang. String  sailorSsn, 

java. lang. String  lastName) 

{ 

try  { 

Navy.spousedescStruct []  spouseData; 

Vector  spouse  =  myDBHelper .getSpouse (sailorSsn, lastName)  ; 
spouseData  =  new  Navy . spousedescStruct [spouse. size ()]  ; 
spouse .  copyinto  (spouseData)  ; 
return (spouseData [0] ) ; 

}  catch  (Exception  e) { 

System.out. printing' System  Exception  in  getSpouse"); 
return  null; 

} 
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} 


/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  leave  periods  of  a  sailor 

* 


*  ©param 

*  ©param 

*  ©return 

* 

*  ©exception 


sailorSsn  Social  security  number  of  the  sailor 

lastName  Last  Name  of  the  sailor 

struct  that  contains  information  about  the 

leave  periods  of  the  sailor 

none 


*/ 

public  Navy . leavedescStruct [] 


getLeaveData (java . lang . String 
sailorSsn, 

java. lang. String  lastName) 


{ 

try  { 

Navy .  leavedescStruct  []  leaveData; 

Vector  leaves  =  myDBHelper  .getLeaveData  (sailorSsn,  lastName)  ; 
leaveData  =  new  Navy . leavedescStruct [leaves . size ()]; 
leaves .  copyinto  (leaveData)  ; 
return (leaveData)  ; 

}  catch  (Exception  e)  { 

System.out .  pr  int  In  ("System  Exception  in  getLeaveData"); 
return  null; 


} 


} 


/*★ 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  prt  results  of  a  sailor  from  the  database 

* 

*  ©param  sailorSsn  Social  security  number  of  the  sailor 

*  ©param  lastName  Last  Name  of  the  sailor 

*  ©return  struct  that  contains  information  about  the 

*  prt  results  of  the  sailor 

*  ©exception  none 
*/ 

public  Navy  .prtdescStruct  []  getPrtResults  (java .  lang .  String 

sailorSsn, 

java. lang. String  lastName) 

{ 

try  { 

Navy. prtdescStruct []  prtData; 

Vector  prtresults  = 

myDBHelper  .getPrtResults  (sailorSsn,  lastName)  ; 
prtData  =  newNavy.prtdescStruct[prtresults.size()]; 
prtresults. copyinto (prtData) ; 
return (prtData) ; 

}  catch  (Exception  e) { 
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} 


} 


System. out. printlnC'System  Exception  in  getPrtResults") ; 
return  null; 


/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  deployment  days  of  a  sailor 

* 


*  ©param 

*  ©param 

*  ©param 

*  ©param 

*  ©return 

* 

*  ©exception 


sailorSsn  Social  security  number  of  the  sailor 

lastName  Last  Name  of  the  sailor 

startDate  The  beginning  of  the  search  period 

stopDate  The  end  of  the  search  period 

struct  that  contains  information  about  the 

deployment  days  of  the  sailor 

none 


*/ 

public  Navy.deploymentStruct  []  getDaysDeployed  (java.  lang.  String 

sailorSsn, 
j  ava . lang . String 
lastName, 
j  ava . lang . String 
StartDate, 
j  ava . lang . String 
StopDate) 

{ 

try  { 


Navy.deploymentStruct []  deploymentData; 

Vector  deployments  = 

myDBHelper . getDaysDeployed  (sailorSsn,  lastName, 

StartDate, StopDate) ; 

System . out .print In ( "Returning  vector "+deployments) ; 
deploymentData  = 

new  Navy.deploymentStruct  [deployments .  size  ( )  ]  ; 
deployments . copyinto (deploymentData) ; 
return (deploymentData) ; 

}  catch  (Exception  e) { 

System.out.println( "System  Exception  in  getDaysDeployed" )  ; 
return  null; 

} 

} 
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/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  properties  of  a  command 

* 

*  ©param  commandid  Specific  command 

*  ©return  struct  that  contains  information  about  the 

*  deployment  days  of  the  sailor 

*  ©exception  none 
*/ 

public  Navy .propertydescStruct []  getPropertyList (java . lang . String 

commandid) 

{ 

try  { 

Navy .propertydescStruct []  proper tyData; 

Vector  properties  =  myDBHelper .getPropertyList (commandid) ; 
propertyData  =  new  Navy. propertydescStruct [properties . size  () ] 
properties . copyinto (propertyData) ; 
return (propertyData) ; 

}  catch  (Exception  e)  { 

System.out.println ("System  Exception  in  getPropertyList"); 
return  null; 

} 

} 


/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  deployment  days  of  a  specific  sailor 

* 


*  ©param 

*  ©param 

*  ©return 

* 

*  ©exception 


commandid  Specific  command 
sex  gender  of  sailors 

struct  that  contains  information  about  the 

deployment  days  of  the  sailor 

none 


*/ 

public  Navy, demographicSt rue t []  getComDemByGender (java. lang. String 

commandid, 
j  ava . lang . String 
sex) 


try  { 

Navy . demographics truct []  demographicData ; 

Vector  demographics  = 

myDBHelper . getComDemByGender (commandid, sex) ; 
demographicData  = 

new  Navy . demographics truct [demographics . size ( ) ] ; 
demographics . copyinto (demographicData) ; 
return (demographicData) ; 

}  catch  (Exception  e)  { 

System,  out  .println  ( "System  Exception  in  getComDemByGender"); 
return  null; 
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} 


/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  demographic  data  of  a  command 

* 


*  ©param 

*  ©param 

*  ©param 

*  ©param 

*  ©return 

* 

*  ©exception 


command Id  ID  Number  for  the  command 

necl  Designation  for  NECl 

nec2  Designation  for  NEC2 

nec3  Designation  for  NEC3 

struct  that  contains  information  about  the 

demographics  of  the  command 

none 


*/ 

public  Navy.demographicStruct[]  getComDemByNec (java. lang. String 

commandid, 

j  ava . lang . String 

necl, 

j  ava . lang . String 
nec2, 

j  ava . lang . String 
nec3) 


try  { 

Navy . demographicStruct []  demographicData ; 

Vector  demographics  =  myDBHelper .getComDemByNec 

(commandId,necl,nec2,nec3); 

demographicData  = 

new  Navy . demographicStruct [demographics . size ( )  ]  ; 
demographics . copyinto (demographicData) ; 
return (demographicData) ; 

}  catch  (Exception  e)  { 

System. out.println( "System  Exception  in  getComDemByGender” ) 
return  null; 


/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  demographic  data  of  a  command  according  to  paygrade 

* 

*  ©param  commandid  ID  Number  for  the  command 

*  ©param  paygrade  The  value  that  defines  the  range  of  rank 

*  ©return  struct  that  contains  information  about  the 

*  demographics  of  the  command 

*  ©exception  none 
*/ 

pviblic  Navy.  demographicStruct  []  getComDemByRank  (java .  lang.  String 

commandid, 
j  ava . lang . String 
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{ 


paygrade ) 


try  { 

Navy . demographicStruct []  demographicData; 

Vector  demographics  = 

myDBHelper . ge tComDemByRank ( commandld , paygrade ) ; 
demographicData  = 

new  Navy  .demographicStruct  [demographics .  size  ( )  ]  ; 
demographics  .  copyinto  (demographicData)  ; 
return (demographicData) ; 

}  catch  (Exception  e)  { 

System. out . printing System  Exception  in  getComDemByGender") ; 
return  null; 

} 

} 

/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  emergency  list  of  a  command 

* 

*  ©param  commandld  ID  Number  for  the  command 

*  ©return  struct  that  contains  information  about  the 

*  emergency  list  of  the  command 

*  ©exception  none 
*/ 

public  Navy.emergencyStruct  []  getEmergencyList  ( java.  lang.  St  ring 

commandld) 

{ 

try  { 

Navy .  emergencyS t ruct  [  ]  emergencyData  ; 

Vector  emergencyList  =  myDBHelper.getEmergencyList(commandld); 
emergencyData  = 

new  Navy.emergencyStruct  [emergencyList . size  ( )  ]  ; 
emergencyList .  copyinto  (emergencyData)  ; 
return  (emergencyData)  ; 

}  catch  (Exception  e) { 

System.out.  print  In  (’’System  Exception  in  getEmergencyList”); 
return  null; 

} 

} 
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/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  sea  missions  conducted  by  a  specific  platform  and  of  a  specific 

*  type  in  a  given  period  of  time 

* 


*  ©param 

*  ©param 

*  ©param 

*  ©param 

*  ©param 

*  ©return 

* 

*  ©exception 


platform 
typeMission 
missionArea 
startDate 
stopDate 
struct  that 
sea  missions 
none 


The  platform  type 
The  type  of  the  mission 
Area  of  interest 
Beginning  date  of  the  period 
Ending  date  of  the  period 
contains  information  about  the 
flown  by  the  platform 


*/ 

public  Navy .  seamissiondescStruct  []  getSeaMissions  ( 

j  ava . lang . String 

platform, 

j  ava . lang . String 

typeMission, 

j  ava . lang . String 

missionArea, 

j ava . lang . String 

StartDate, 

j  ava . lang . String 

StopDate) 

{ 

try  { 


Navy . seamissiondescStruct [] seamisdescData; 

Vector  missions  =  myDBHelper .getSeaMissions (platform, 

typeMission, 
missionArea, 
StartDate, 
StopDate) ; 

seamisdescData  = 


new  Navy. seamissiondescStruct [missions. size  0 ] ; 
missions . copyinto (seamisdescData) ; 
return (seamisdescData) ; 

}  catch  (Exception  e) { 

System. out .print In ("System  Exception  in  getSeaMissions"); 
return  null; 

} 

} 
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*  This  method  is  used  by  the  client  to  get  information  about  the 

*  sea  missions  conducted  by  a  specific  platform 

*  in  a  given  period  of  time 

* 


*  ©param 

*  ©param 

*  ©param 

*  ©return 

* 

*  ©exception 


platform  The  platform  type 

startDate  Beginning  date  of  the  period 

stopDate  Ending  date  of  the  period 

struct  that  contains  infonnation  about  the 

sea  missions  flown  by  the  platform 

none 


*/ 

public  Navy.seamissiondescStruct  []  getSeaMissionsByPlatform  ( 

java . lang . String 
platform, 
j  ava . lang . String 
StartDate, 
j  ava . lang . String 
StopDate) 

{ 


try  { 

Navy.seamissiondescStruct  []  seamisdescData; 

Vector  missions  =  myDBHelper .getSeaMissionsByPlatform 

(platform, StartDate,  stopDate) ; 


seamisdescData  = 

new  Navy .  seamissiondescStruct  [missions  .  size  0  ]  ; 
missions , copyinto (seamisdescData) ; 
return (seamisdescData) ; 

}  catch  (Exception  e) { 

System.out.  print  In  ("System  Exception  in 

GetSeaMissionsByPlatform”) ; 

return  null; 

} 

} 


/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  sea  missions  conducted  in  a  certain  mission  area 

*  in  a  given  period  of  time 

* 


*  ©param 

*  ©param 

*  ©param 

*  ©return 

* 

*  ©exception 


missionArea  Area  of  interest 
StartDate  Beginning  date  of  the  period 
StopDate  Ending  date  of  the  period 
struct  that  contains  information  about  the 
sea  missions  flown  that  meets  criteria 
none 


*/ 

public  Navy.seamissiondescStruct [] 


getSeaMissionsByArea ( 

j  ava . lang . String 
missionArea, 
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j  ava . lang . String 
startDate, 
j  ava . lang . String 
stopDate) { 

try  { 

Navy, seamissiondescStruct [] seamisdescData; 

Vector  missions  =  myDBHelper .getSeaMissionsByArea 

(missionArea, StartDate,  stopDate) ; 

seamisdescData  = 

new  Navy. seamissiondescStruct [missions . size ( ) ] ; 

missions . copyinto (seamisdescData) ; 

return (seamisdescData) ; 

}  catch  (Exception  e)  { 

System.out.println( "System  Exception  in 

getSeaMissionsByArea") ; 

return  null; 

} 

} 


/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  sea  missions  conducted  of  a  specified  type 

*  in  a  given  period  of  time 


*  @param 

*  ©param 

*  ©param 

*  ©return 

* 

*  ©exception 
*/ 


typeMission  The  type  of  the  mission 
StartDate  Beginning  date  of  the  period 
StopDate  Ending  date  of  the  period 
Struct  that  contains  information  about  the 
sea  missions  flown  that  meets  criteria 
none 


piiblic  Navy.  seamissiondescStruct  []  getSeaMissionsByType  ( 

j  ava . lang . String 

typeMission, 

j  ava . lang . String 

StartDate, 

j  ava . lang . String 

StopDate) 

try  { 

Navy. seamissiondescStruct [] seamisdescData; 

Vector  missions  =  myDBHelper .getSeaMissionsByType 

(typeMission,  startDate,  stopDate) ; 


seamisdescData  = 

new  Navy. seamissiondescStruct [missions. size  0 ] ; 
missions . copyinto (seamisdescData) ; 
return (seamisdescData) ; 

}  catch  (Exception  e)  { 

Sys tern. out. println ("System  Exception  in 
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getSeaMissionsByArea” ) ; 

return  null; 

} 

} 

/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  sea  missions  conducted  in  the  exercise  specified 

*  in  a  given  period  of  time 

* 

*  ©param  exerciseName  Name  of  the  exercise 

*  ©param  startDate  Beginning  date  of  the  period 

*  ©param  stopDate  Ending  date  of  the  period 

*  ©return  struct  that  contains  information  about  the 

*  sea  missions  flown  that  meets  criteria 

*  ©exception  none 
*/ 

public  Navy.seamissiondescStruct []  getSeaMissionsByExercise { 

j  ava . lang . String 

exerciseName, 

j  ava . lang . String 

StartDate, 

j  ava . lang . String 

StopDate) 

{ 

try  { 

Navy.seamissiondescStruct  []  seamisdescData; 

Vector  missions  =  myDBHelper .getSeaMissionsByExercise 

(exerciseName, startDate, 

StopDate) ; 

seamisdescData  = 

new  Navy. seamissiondescStruct [missions . size  0 ] ; 
missions . copyinto (seamisdescData) ; 
return (seamisdescData) ; 

}  catch  (Exception  e)  { 

System. out .printlnC System  Exception  in 

getSeaMissionsByExercise”) ; 

return  null; 

} 

} 
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/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  sea  missions  conducted  by  a  specific  platform 

*  in  a  given  period  of  time 

* 

*  ©param  platform  The  platform  type 

*  ©param  startDate  Beginning  date  of  the  period 

*  ©param  stopDate  Ending  date  of  the  period 

*  ©return  struct  that  contains  information  about  the 

*  sea  missions  flown  that  meets  criteria 

*  ©exception  none 
*/ 

public  Navy .  seamissiondescStruct  []  getSeaMissionsByPlatf  ormName 

( j  ava . lang . S  tring 

platform, 

j ava . lang . String 

StartDate, 

j  ava . lang . String 

StopDate) 

{ 

try  { 

Navy.  seamissiondescStruct  []  seamisdescData; 

Vector  missions  =  myDBHelper. get SeaMisByPlatf ormName 

(platform,  startDate,  stopDate) ; 

seamisdescData  = 

new  Navy . seamissiondescStruct [missions . sizeO ] ; 
missions  .  copyinto  (seamisdescData)  ; 
return (seamisdescData) ; 

}  catch  (Exception  e) { 

System.out.  print  In  ("System  Exception  in 

getSeaMissionsByPlatformName”)  ; 

return  null; 

} 

} 

/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  air  missions  flown  by  a  specific  squadron  and  of  a  specific 

*  mission  type  in  a  given  period  of  time 

* 

*  ©param  squadron  The  squadron  name 

*  ©param  platform  The  platform  type 

*  ©param  typeMission  The  type  of  the  mission 

*  ©param  missionArea  Area  of  interest 

*  ©param  startDate  Beginning  date  of  the  period 

*  ©param  stopDate  Ending  date  of  the  period 

*  ©return  struct  that  contains  information  about  the 

*  air  missions  flown  that  meets  criteria 

*  ©exception  none 
*/ 
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public  Navy.airmissiondescStruct []  getAirMissions ( 

java . lang . String 

squadron, 

java . lang . String 

platform, 

j  ava . lang . String 

typeMission, 

j  ava . lang . String 

missionArea, 

j  ava . lang . String 

startDate, 

j  ava . lang . String 

stopDate) 

{ 

try  { 

Navy.airmissiondescStruct []  airmisdescData ; 

Vector  missions  =  myDBHelper .getAirMissions 
{  squadron,  platform,  typeMission,  missionArea,  startDate, 

StopDate) ; 

airmisdescData  = 

new  Navy.airmissiondescStruct  [missions  .size  0  ]  ; 

missions . copyinto (airmisdescData) ; 

return (airmisdescData) ; 

}  catch  (Exception  e)  { 

System. out .println( "System  Exception  in  getAirMissions"); 

return  null; 

} 

} 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  air  missions  flown  by  a  specific  platform 

*  in  a  given  period  of  time 

* 

*  ©param  platform  The  platform  type 

*  ©param  startDate  Beginning  date  of  the  period 

*  ©param  stopDate  Ending  date  of  the  period 

*  ©return  struct  that  contains  information  about  the 

*  air  missions  flown  that  meets  criteria 

*  ©exception  none 

*/ 

public  Navy.airmissiondescStruct  []  getAirMisByPlatformNo  ( 

j  ava . lang . String 

platform, 

j  ava . lang . String 

StartDate, 

j  ava . lang . String 

StopDate) 

{ 

try  { 
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Navy.airmissiondescStruct  []  airmisdescData; 

Vector  missions  :=  myDBHelper  .getAirMisByPlatformNo 
{  platform,  startDate,  stopDate) ; 

airmisdescData  = 

new  Navy.airmissiondescStruct  [missions. size  0  ]  ; 
missions . copyinto (airmisdescData) ; 
return (airmisdescData) ; 

}  catch  (Exception  e)  { 

System.out.println( "System  Exception  in 

getAirMisByPlatformNo") ; 

return  null; 

} 

} 


/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  air  missions  flown  in  a  specified  area 

*  in  a  given  period  of  time 

* 


*  ©param 

*  ©param 

*  ©param 

*  ©return 

* 

*  ©exception 


missionArea  Area  of  interest 
StartDate  Beginning  date  of  the  period 
StopDate  Ending  date  of  the  period 
struct  that  contains  information  about  the 
air  missions  flown  that  meets  criteria 
none 


*/ 

public  Navy.airmissiondescStruct  []  getAirMisByArea  ( 

j  ava . lang . String 

missionArea, 

j  ava . lang . String 

StartDate, 

j  ava . lang . String 

StopDate) 

{ 

try  { 


Navy.airmissiondescStruct []  airmisdescData; 
Vector  missions  =  myDBHelper .getAirMisByArea 
(  missionArea,  startDate,  stopDate) ; 


airmisdescData  = 

new  Navy.airmissiondescStruct  [missions. size  0  ]  ; 
missions .  copyinto  (airmisdescData)'; 
return  (airmisdescData)  ; 

}  catch  (Exception  e)  { 

System,  out  .print  In  ("System  Exception  in  getAirByArea" )  ; 
return  null; 

} 

} 
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J'k'k 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  air  missions  flovm  of  a  specified  mission  type 

*  in  a  given  period  of  time 

* 

*  ©param  typeOfMission  The  type  of  the  mission 

*  ©param  startDate  Beginning  date  of  the  period 

*  ©param  stopDate  Ending  date  of  the  period 

*  ©return  struct  that  contains  information  about  the 

*  air  missions  flown  that  meets  criteria 

*  ©exception  none 
*/ 

public  Navy.airmissiondescStruct []  getAirMisByType ( 

j  ava . lang . String 
typeOf Mi s  s ion , 
j  ava . lang . String 
StartDate, 
j  ava . lang . String 
StopDate) 

{ 

try  { 

Navy.airmissiondescStruct  []  airmisdescData; 

Vector  missions  =  myDBHelper .getAirMisByType 
(  typeOfMission,  startDate,  stopDate) ; 

airmisdescData  = 

new  Navy. airmissiondescStruct [missions . size  0 ] ; 
missions .copy Into  (airmisdescData) ; 
return (airmisdescData) ; 

}  catch  (Exception  e)  { 

System,  out .  print  In  ("System  Exception  in  getAirMisByType"); 
return  null; 

} 

} 

/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  air  missions  flown  in  a  specified  exercise 

*  in  a  given  period  of  time 

* 

*  ©param  exerciseName  Name  of  the  exercise 

*  ©param  startDate  Beginning  date  of  the  period 

*  ©param  stopDate  Ending  date  of  the  period 

*  ©return  struct  that  contains  information  about  the 

*  air  missions  flown  that  meets  criteria 

*  ©exception  none 
*/ 

public  Navy  .airmissiondescStruct  []  getAirMisByExercise  ( 

j  ava . lang . String 
exerciseName, 
j  ava . lang . String 
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startDate, 

j  ava . lang . String 

stopDate) 

{ 

try  { 

Navy.airmissiondescStruct []  airmisdescData; 

Vector  missions  =  myDBHelper .getAirMisByExercise 
(  exerciseName,  startDate,  stopDate) ; 

airmisdescData  = 

new  Navy.airmissiondescStruct [missions. size  0 ] / 
missions . copyinto (airmisdescData) ; 
return (airmisdescData) ; 

}  catch  (Exception  e)  { 

System.out.println( "System  Exception  in  getAirMisByExercise”) 
return  null; 

} 

} 

/** 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  air  missions  flown  by  a  specific  squadron 

*  in  a  given  period  of  time 

* 

*  ©param  squadronName  The  squadron  name 

*  ©param  startDate  Beginning  date  of  the  period 

*  ©param  stopDate  Ending  date  of  the  period 

*  ©return  struct  that  contains  information  about  the 

*  air  missions  flown  that  meets  criteria 

*  ©exception  none 
*/ 

pioblic  Navy.airmissiondescStruct []  getAirMisBySquadron ( 

j  ava . lang . String 
squadronName , 
j  ava . lang . String 
StartDate, 
j  ava . lang . String 
StopDate) 

{ 

try  { 

Navy.airmissiondescStruct []  airmisdescData; 

Vector  missions  =  myDBHelper .getAirMisBySquadron 
(  squadronName  ,  startDate,  stopDate) ; 

airmisdescData  = 

new  Navy.airmissiondescStruct [missions . size  0 ]  ; 
missions . copyinto (airmisdescData) ; 
return (airmisdescData) ; 

}  catch  (Exception  e) { 

System.out.println( "System  Exception  in  getAirMisBySquadron") 
return  null; 
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J-k-k 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  maintenance  data  stored  for  the  inventory  of  a  command 

*  in  a  given  period  of  time 

* 


*  ©param 

*  ©param 

*  ©param 

*  ©param 

*  ©return 

* 

*  ©exception 


commandid  ID  Number  of  the  command 
department  Id  ID  Number  of  the  department 
startDate  Beginning  date  of  the  period 
stopDate  Ending  date  of  the  period 
struct  that  contains  information  about  the 
maintenance  data  that  meets  criteria 
none 


*/ 

publ ic  Navy . commaintenanceS truct [  ] 


getMaintByCommand ( 

j  ava . lang . String 
commandid, 
j  ava . lang . String 
department Id, 
j  ava . lang . String 
StartDate, 
j  ava . lang . String 
StopDate) { 


try  { 

Navy .  commaintenanceS  truct  [  ]  commaint  enanceData  ; 

Vector-  maintenanceList  =  myDBHelper .getMaintByCommand 

(commandid,  department Id,  startDate,  stopDate) ; 


commaintenanceData  =  new  Navy .  commaintenanceS  truct 

[maintenanceList . size ( ) ] ; 
maintenanceList .  copyinto  (commaintenanceData)  ; 
return (commaintenanceData) ; 

}  catch  (Exception  e) { 

System, out .println( "System  Exception  in  getMaintByCommand"); 
return  null ; 

} 

} 


/*★ 

*  This  method  is  used  by  the  client  to  get  information  about  the 

*  maintenance  data  stored  about  an  item  in  the  database 

* 

*  ©param  itemid  ID  Number  of  the  item 

*  ©return  struct  that  contains  information  about  the 

*  maintenance  data  that  meets  criteria 

*  ©exception  none 
*/ 

public  Navy.itemmaintenanceStruct []  getMaintByltera ( 
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{ 


j  ava . lang . String 
itemid) 


try  { 

Navy .  itemmaintenanceStruct  []  itemmaintenanceData  ; 

Vector  maintenanceList  =  myDBHelper  .getMaintByl tern  (itemid)  ; 

itemmaintenanceData  =  new  Navy .  itemmaintenanceStruct 

[maintenanceList . size  ( ) ] 
maintenanceList .  copyinto  (itemmaintenanceData)  ; 
return  (itemmaintenanceData)  ; 

}  catch  (Exception  e)  { 

System. out .println(" System  Exception  in  getMaintByl tern") ; 
return  null; 

} 

} 

}//  End  NavSecImpl . java 
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// - 

//  Filename 
//  Author 
//  Date 
//  Compiler 
// - 


DBHelper . java 

Murat  Akbay  &  Steve  Lewis 

10/09/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


/★* 

*  Server  component  that  uses  JDBC  to  access  the  back-end  database  and 

*  execute  the  queries  on  that  database,  the  results  of  the  query  are 

*  returned  as  a  vector  of  structs  to  the  calling  class 

* 

*  ©author  Murat  Akbay  &  Steve  Lewis 
*/ 

import  j  ava . net . URL ; 
import  j  ava . sql . * ; 
import  java.util 

public  class  DBHelper { 


Connection  con; 

Driver  driver  =  null; 
ResultSet  rs; 
PreparedStatement  pstmt ; 
boolean  debug  =  false; 


/** 

*  This  method  is  used  to  open  a  connection  to  the  database  through 

*  port  1433 


*  ©param 

* 

*  ©return 

*  ©exception 
*/ 


address  of  computer  where  database  is  held,  database 

name,  user  ID,  and  password 

none 

system  exception  to  catch  all  problems 


p\iblic  void  connect  (String  address.  String  db.  String  id,  String  pw) 

throws  Exception 


{ 


try 

{ 

//Load  the  fast forward  jdbc  driver 

Class  .forName  ("connect  .microsoft.MicrosoftDriver”)  ; 

String  url=  " jdbc : f f-microsoft : //"  +  address  +  ”:1433/"  +  db; 

System.out.println( "Connecting  to”  +  url  ); 

con  =  DriverManager. get Connect ion (  url  ,  id  ,  pw)  ; 

} 

catch (Exception  e) 

{ 

System. err .print In ( "System  Exception  in  connect"); 

System. err. println(e) ; 
throw  e; 
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} 

} 


/** 

*  This  method  is  used  to  close  the  connection  with  the  database 

* 

*  ©par am  none 

* 

*  ©return  none 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  void  closeConnection ()  throws  Exception 

{ 

try 

{ 

System. err.println( "Closing  connection") ; 
con. close () ; 

} 

catch (Exception  e) 

{ 

System,err.println( "System  Exception  in  closeConnection")  ; 
System.err. print In (e) ; 
throw  e; 

} 

} 


/** 

*  This  method  is  used  to  query  the  database  for  a  specific  sailors 

*  address  information  based  on  the  input  of  an  SSN. 

* 


*  ©param  adressData  address  struct  that  contains  all  applicable 

*  information 

* 


*  ©return  boolean 

*  ©exception  system  exception  to  catch  all  problems 


*/ 

public  boolean  addAdress (  Navy. adress Struct  adressData) 

throws  Exception 


{ 


try 

{ 

pstmt  =  con. prepares tatement ( 

"UPDATE  SAILOR  SET  "+ 
"ADDRESS  =  ?  ,  "+ 

"CITY  =  ?  ,  "+ 
"STATEORPROVINCE  =  ?  , "+ 
"COUNTRY  =  ?  ,  "+ 

"POSTALCODE  =  ?  ,  "+ 
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"HOMEPHONE  =  ?  "+ 

"WHERE  Social_Security_Number  =  ?  ”)  ; 
pstmt . set String (  1 ,  adressData , adress) ; 
pstmt . setstring (  2,  adressData . city) ; 
pstmt . setstring (  3 ,  adressData . state) ; 
pstmt . setstring (  4 ,  adressData . country) ; 
pstmt . setstring (  5,  adressData .postalCode)  ; 
pstmt . setstring (  6 ,  adressData . homePhone)  ; 
pstmt . setstring (  7 ,  adressData . ssn) ; 

pstmt . executeUpdate ( ) ; 
pstmt  .close  0  ; 
con. commit { ) ; 
if (debug  ==  true) { 

System.out.println(” Query  run  successfully"); 

} 

return  true; 

} 

catch (Exception  e) 

{ 

System.err.println ("System  Exception  in  addAdress”); 

System. err .println (e)  ; 
throw  e; 

} 

} 

/** 

*  This  method  is  used  to  add  a  family  member  to  the  database 

*  regarding  a  specific  sailor 

* 

*  ©param  family  struct  that  contains  all  applicable  information 

* 

*  ©return  boolean 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

pi;iblic  boolean  addFamily(  Navy .  familyStruct  familyData) 

throws  Exception  ‘ 

{ 

java. sql .Date  bdate=  j ava.sql. Date. valueOf (familyData. sdate) ; 
try 
{ 

pstmt  =  con.prepareStatement ( 

"  INSERT  INTO  FAMILY_MEMBERS  "+ 

"(  FAMILY_MEMBER_SOCIAL_SECURITY_,  "+ 

"  NAME,  BIRTHDATE  ,  SEX, "+ 

"  SAILOR_SOCIAL_SECURITY_NUMBER)  + 

"  VALUES  (  ?  , ?  , ?  , ?  , ?  )  ” ) ; 

pstmt . setstring (  1,  familyData . ssn) ; 
pstmt . setstring {  2,  f ami lyData. name); 
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pstmt . setDate (  3,  bdate) ; 

pstmt. setstring (  4,  familyData.sex)  ; 

pstmt .  setstring  (  5,  familyData .  sailorSsn)  ; 

pstmt ,  executetJpdate  ( )  ; 

pstmt .  close  ()  ; 

con,  commit  0  ; 

if (debug  ==  true) { 

System.out.  print  In  ("Query,  run  successfully”)/ 

} 

return  true; 

} 

catch (Exception  e) 

{ 

System. err. printlnC'System  Exception  in  addFamily")  ; 
System. err. println(e) ; 
throw  e; 

} 

} 


/** 

*  This  method  is  used  to  add  a  spouse  of  a  specific  sailor  to  the 

*  database 


*  ©param  spouse  struct  that  contains  all  applicable  information 

* 


*  ©return  boolean 


*  ©exception  system  exception  to  catch  all  problems 
*/ 


pviblic  boolean  addSpouses  ( 
{ 


Navy.spouseStruct  spouseData) 
throws  Exception 


java.sgl.Date  birthDate=  j ava . sql . Date . valueOf (spouseData. bdate) 
j  ava . sql . Date  uDate=  j  ava . sql . Date . valueOf ( spouseData . update ) ; 
try 


{ 


pstmt  =  con.prepareStatement ( 

"  INSERT  INTO  SPOUSES  '•  + 

"  (  SPOUSE_SOCIAL_SECURITy_NUMBER,  '■  + 

"  SPOUSE_NAME,  SPOUSE_DATE_OF_BIRTH  ,  SPOUSE_GENDER, ”+ 
''  SAILOR_SOCIAL_SECURITy_NUMBER  ,  "  + 

"  DATEUPDATED)  "+ 

"  VALUES  (?,?,?,?,?,?)"); 
pstmt. setString(  1,  spouseData.ssn) ; 
pstmt . setstring {  2,  spouseData. name ) ; 
pstmt . setDate (  3,  birthDate); 
pstmt. setstring (  4,  spouseData. gender) ; 
pstmt. setstring (  5,  spouseData.sailorSsn); 
pstmt . setDate (  6,  uDate) ; 
pstmt . executeUpdate { ) ; 
pstmt. close  0; 
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con . commit ( ) ; 
if (debug  ==  true) { 

System.out. print In ("Query  run  successfully"); 

} 

return  true; 

} 

catch (Exception  e) 

{ 

System.err. print In ("System  Exception  in  addSpouses"); 
System. err .print In (e) ; 
throw  e; 

} 

} 


/★* 

*  This  method  is  used  to  add  the  PRT  data  of  a  specific  sailor  to 

*  the  database 

* 

*  ©param  PRT  struct  that  contains  all  applicable  information 

* 

*  ©return  boolean 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  boolean  addPrt (  Navy.prtStruct  prtData  ) throws  Exception 

{ 

java.sql.Date  prtDate=  java . sql .Date .valueOf (prtData .pdate) ; 
try 
{ 

pstmt  =  con.prepareStatement ( 

"  INSERT  INTO  PRT_DATA(  COMMAND___ID,  ”  + 

"  PRT_IDENTIFIER,  HEIGHT,  WEIGHT  ,  "+ 

”  PUSHUPS,  SITUPS  ,  RUN_TIME,  PRT_DATE,  "  + 

"  STATUS,  SOCIAL_SECURITY_NUMBER)  ”  + 

"  VALUES  (?,?,?,?,?,?,?,?,?,?)  "); 

pstmt . setstring (  1 ,  prtData . commandid) ; 
pstmt . setstring (  2 ,  prtData . identifier) ; 
pstmt . setstring (  3,  prtData.height) ; 
pstmt . sets tring (  4 ,  prtData . weight ) ; 
pstmt . set String (  5,  pr tData. pushups ) ; 
pstmt . setstring (  6 ,  prtData . sitUps) ; 
pstmt . setstring (  7 ,  prtData . runTime) ; 
pstmt . setDate (  8 ,  prtDate) ; 
pstmt.setString(  9,  prtData . status) ; 
pstmt . setstring (10 ,  prtData. ssn) ; 
pstmt . executeUpdate ( ) ; 
pstmt.  close  0  ; 
con. commit  () ; 
if (debug  ==  true) { 

System. out. print In ("Query  run  successfully"); 

} 
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return  true; 


} 

catch (Exception  e) 

{ 

System. err. println( "System  Exception  in  addPrt"); 
System. err. println(e) ; 
throw  e; 

} 


} 


/** 

*  This  method  is  used  to  modify  a  members  leave  data  in 

*  the  database 

* 

*  ©param  leave  struct  that  contains  all  applicable  information 

* 

*  ©return  boolean 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

pxiblic  boolean  addLeavet  Navy . leaves truct  leaveData) 

throws  Exception 

{ 

java.sql.Date  dateDepart  = 

j  ava .  sql .  Date .  valueOf  ( leaveData .  departDate )  ; 
java.sql.Date  dateReturn  = 

j  ava .  sql .  Date .  valueOf  ( leaveData .  returnDate )  ; 

try 

{ 

pstmt  =  con . prepareStatement ( 

"  INSERT  INTO  LEAVE (  COMMAND_ID, "+ 

"  LEAVE_CONTROL_NUMBER,  "+ 

"  TyPE_OF_LEAVE,  DATE_OF_DEPARTURE, "+ 

"  DATE_OF_RETtJRN  ,  "  + 

"  SOCIAL_SECURITY_NtlMBER)  "  + 

"  VALUES  {  ?  ,7  ,7  ,7  ,7  ,7  )  " )  ; 

pstmt . setstring (  1,  leaveData. commandid) ; 

pstmt . setstring (  2,  leaveData.leaveControlNumber); 

pstmt . setstring (  3,  leaveData . typeOf Leave ) ; 

pstmt . setDate (  4,  dateDepart); 

pstmt . setDate (  5 ,  dateReturn) ; 

pstmt . setstring {  6,  leaveData. ssn) ; 

pstmt . executeUpdate ( ) ; 

pstmt .  close  0  ; 

con.  commit  ()  ; 

if (debug  ==  true) { 

System.out.println( "Query  run  successfully"); 

} 

return  true ; 
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} 

catch (Exception  e) 

{ 

System. err.println{ "System  Exception  in  addLeave"); 
System. err .print In (e) ; 
throw  e; 

} 

} 


*  This  method  is  used  to  add  a  new  NEC  to  a  specific  sailor  in 

*  the  database 

* 

*  ©param  NEC  struct  that  contains  all  applicable  information 

* 

*  ©return  boolean 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  boolean  addNec (  Navy.necStruct  necData)  throws  Exception 

{ 

java. sql .Date  lastUpDate  = 

j ava . sql . Date . valueOf (necData . lastDate)  ; 


try 

{■ 

pstmt  =  con.prepareStatement ( 

"  UPDATE  SAILOR  SET  PRIMARY_NEC_DESIGNATOR  =  ?  ,  "  + 
"  SECONDARY_NEC  =  ?  ,  TERTIARY_NEC  =  ?  ,  ”+ 

”  LAST^UPDATED  :=  ?  "  + 

"  WHERE  SOCIAL_SECURITY_NUMBER  =  ?  " )  ; 

pstmt . setstring (  1,  necData. pr imaryNec ) ; 

pstmt . setstring (  2 ,  necData . secondaryNec) ; 

pstmt . setstring (  3,  necData. tertiaryNec)  ; 

pstmt . setDate (  4 ,  lastUpDate) ; 

pstmt . setstring (  5,  necData. ssn) ; 

pstmt . executeUpdate ( ) ; 

pstmt . close () ; 

con. commit () ; 

if (debug  ==  true) { 

System.out. print In ("Query  run  successfully"); 

} 

return  true; 

} 

catch (Exception  e) 

{  System. err .println ( "System  Exception  in  addNec"); 

System. err .println (e) ; 
throw  e; 

} 


} 


158 


/** 

*  This  method  is  used  to  add  new  minor  property  data  to 

*  the  database 

*  @param  property  struct  that  contains  all  applicable 

*  information 

* 

*  ©return  boolean 

*  ©exception  system  exception  to  catch  all  problems 

*/ 

pviblic  boolean  addProperty (  Navy.propertyStruct  propertyData) 

throws  Exception 

{ 

int  propertyPrice  = 

(Integer .valueOf (propertyData. price) ) .int Value () ; 
java,  util  .Date  dateNow  =  new  java.util.DateO; 
java. sql  .Date  sqlDate  =  new  java . sql  .Date  ( dateNow.get Year  ()  , 
dateNow. getMonthO  ,  dateNow. getDayO  )  ; 
j  ava . sql . Date  datePurchase  = 

java . sql . Date . valueOf (propertyData .purchaseDate) ; 

try 

{ 

pstmt  =  con.prepareStatement ( 

"  INSERT  INTO  PROPERTIES_LISTING (  PROPERTY_ID, "+ 

•'  PROPERTY_DESCRIPTION,  ”  + 

•'  DATE_PURCHASED,  PRICE,  COMMAND_ID ,  SIIBCUSTODIED,  "  + 
"  PURCHASER,  INVENTORY,  "+ 

"  liAST_INVENTORY_DATE,  PDRCHASE_CATEGORY  )  "  + 

"  VALUES  (?,?,?,?,?,?,?,?,?,?)  "); 

pstmt . setstring (  1,  propertyData . propertyld)  ; 
pstmt. setstring (  2,  propertyData.propertyDesc); 
pstmt . setDate (  3,  datePurchase); 
pstmt . setint (  4,  propertyPrice); 
pstmt . setstring (  5,  propertyData . commandid)  ; 
pstmt. setstring (  6,  propertyData.purchaser); 
pstmt . setstring (  7,  propertyData.purchaser); 
pstmt . setstring (  8,  propertyData.purchaser); 
pstmt . setDate (  9,  sqlDate); 

pstmt . setstring (  10,  propertyData. purchaseCategory )  ; 

pstmt . executeUpdate ( )  ; 

pstmt . close  0 ; 

con . commit ( )  ; 

if (debug  ==  true) { 

System. out.println( "Query  run  successfully"); 

} 

return  true; 

} 

catch (Exception  e) 

{  System. err. println( "System  Exception  in  addProperty"); 

System. err. println(e) ; 
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throw  e; 


} 

} 

f-k-k 

*  This  method  is  used  to  add  a  new  department  to 

*  the  database 

k 

*  ©param  department  struct  that  contains  all  applicable 

*  information 

* 

*  ©return  boolean 

*  ©exception  system  exception  to  catch  all  problems 

*/ 

public  boolean  addDepartment  {  Navy .  departments truct  departmentData) 

throws  Exception 

{ 

try 

{ 

pstmt  =  con. prepares tatement ( 

*'  INSERT  INTO  DEPARTMENT  (  ”  + 

”  COMMAND_ID,  DEPARTMENT_ID ,  TITLE  ,  "  + 

*'  DEPARTMENT_HEAD_SSN,  DEPARTMENT_CHIEF_SSN,  ” + 

"  TELEPHONE,  EMAIL  ) "+ 

"  VALUES  (?,?,?,?,?,?,?  )  ”); 

pstmt . setstring {  1 ,  departmentData . commandid) ; 
pstmt .setstring {  2,  departmentData .department Id) ; 
pstmt . setstring (  3 ,  departmentData . title) ; 
pstmt .setstring {  4,  departmentData. headSsn) ; 
pstmt . setstring (  5 ,  departmentData . chief Ssn) ; 
pstmt . setstring (  6 ,  departmentData . telephone) ; 
pstmt . set String (  7 ,  departmentData . email) ; 
pstmt . executeUpdate { ) ; 
pstmt . close () ; 
con . commit ( ) ; 
if (debug  ==  true) { 

System. out . print In ("Query  run  successfully"); 

} 

return  true; 

} 

catch (Exception  e) 

{ 

System. err.println( "System  Exception  in  addDepartment")  ; 
System. err. println(e) ; 
throw  e; 

} 

} 
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/** 

*  This  method  is  used  to  add  a  new  division  to  a  department 

*  in  the  database 

* 


*  ©param  division  struct  that  contains  all  applicable 

*  information 

* 


*  ©return  boolean 


*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  boolean  addDivision(  Navy.divisionStruct  divisionData) 

throws  Exception 


{ 


try 

{ 

pstmt  =  con. prepares tatement ( 

”  INSERT  INTO  DIVISION (  COMMAND_ID ,  DEPARTMENT_ID,  "  + 
”  DIVISION_ID,  TITLE  , ”+ 

"  DIVISION_OFFICER_SSN,  DIVISION_CHIEF_SSN,  "  + 

”  TELEPHONE,  EMAIL  )  »+ 

”  VALUES  » ) ; 


pstmt. setstring (  1,  divisionData. commandid) ; 
pstmt . setstring (  2,  divisionData. department Id)  ; 
pstmt . setstring (  3,  divisionData. divisionid) ; 
pstmt . setstring (  4,  divisionData. title) ; 
pstmt . setstring (  5 ,  divisionData . headSsn) ; 
pstmt . setstring {  6,  divisionData. chief Ssn) ; 
pstmt . setstring (  7,  divisionData . telephone) ; 
pstmt . setstring (  8 ,  divisionData . email) ; 
pstmt . executeUpdate ( ) ; 
pstmt . close () ; 
con.  commit  {)  ; 
if (debug  ==  true) { 

System. out . print In ("Query  run  successfully"); 

} 

return  true; 


} 

catch (Exception  e) 

{ 

System. err.println( "System  Exception  in  addDivision"); 
System. err. println(e) ; 
throw  e ; 

} 

} 
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*  This  method  is  used  to  add  maintenance  completed  to 

*  the  database 
*■ 

*  ©param  maintenance  struct  that  contains  all  applicable 

*  information 

* 

*  ©return  boolean 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

piiblic  boolean  addMaintLog (Navy.maintenanceStruct  maintenanceData) 

throws  Exception 


{ 


java.sql.Date  dateConduct  = 

java.sql .Date . valueOf (maintenanceData. dateOf Conduct) 


try 

{ 

double  hours  = 

(Double .  valueOf  (maintenanceData .  hoursOn Job)  )  .  doubleValue  ( ) 
pstmt  =  con. prepares tatement ( 

"  INSERT  INTO  MAINTENANCE  (  PERSON,  ”  + 

"  MAINTENANCE_NUMBER,  ITEM_ID,  PMS_ITEM_NUMBER  ,  "  + 

«  DATE_CONDUCTED,  REPAIR_PRIORITY,  "  + 

"  EMERGENCY_DESCRIPTION,COMMAND_ID  ,  "  + 

"  DEPARTMENT_ID,  DIVISION__ID,  HOURS  ON  JOB)  "  + 

"  VALUES  (?,?,?,?,?,?,?,?,?,?,?)"); 

pstmt . setstring (  1 ,  maintenanceData . person) ; 

pstmt . setstring (  2 ,  maintenanceData . maintenanceNumber )  ; 

pstmt . setstring (  3 ,  maintenanceData . itemid) ; 

pstmt. setstring (  4,  maintenanceData .pmsNumber) ; 

pstmt . setDa te (  5 ,  dateConduct ) ; 

pstmt. setstring (  6,  maintenanceData .priority) ; 

pstmt . setstring (  7,  maintenanceData . emDescript ion) ; 

pstmt . setstring (  8 ,  maintenanceData . commandid) ; 

pstmt . setstring (  9 ,  maintenanceData . departmentid) ; 

pstmt. setstring (  10,  maintenanceData .divisionid) ; 

pstmt . setDouble (  11 ,  hours) ; 

pstmt . executeUpdate ( ) ; 

pstmt  .close  0  ; 

con. commit () ; 

if (debug  ==  true) { 

System. out . print In ("Query  run  successfully"); 

} 

return  true; 

} 

catch (Exception  e) 

{  System. err.println( "System  Exception  in  addMaintLog"); 

System. err .println (e) ; 
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throw  e; 


/** 

*  This  method  is  used  to  add  a  new  sailor  to 

*  the  database 

* 

*  ©param  sailor  struct  that  contains  all  applicable 

*  information 

* 

*  ©return  boolean 

*  ©exception  system  exception  to  catch  all  problems 

*/ 

public  boolean  addSailor(  Navy.sailorStruct  sailorData) 

throws  Exception 


{ 


java. util. Date  dateNow  =  new  j ava. util .Date () ; 
j  ava . sql . Date  dateRank  = 

j ava. sql. Date. valueOf (sailorData . dateOf Rank) ; 
j ava . sql . Date  dateBirth  = 

j  ava . sql . Date . valueOf (sailorData . dateOf Birth) ; 
java. sql .Date  dateService  = 


java. sql. Date. valueOf (sailorData. dateOf Service) ; 
j  ava . sql . Date  dateUpdate  =  new  j  ava . sql . Date (dateNow . getYear ( ) , 

dateNow . getMonth ( ) ,  dateNow . getDay ( ) ) ; 


try 

{ 


pstmt  =  con.prepareStatement ( 


"  INSERT  INTO  SAILOR  (  SOCIAL_SECURITY_NUMBER  ,  ■'  + 

"  FIRSTNAME,  MIDDLENAME,  LASTNAME,  •'  + 

"  SEX,  RANK_RATE,  DATE_OF_RANK,  WARFARE_DEVICE_1 , "+ 
"  WARFARE_DEVICE_2 ,  WARFARE_DEVICE_3 ,  ”  + 

"  PRIMARY_NEC_DESIGNATOR,  SECONDARY_NEC ,  "  + 

"  TERTIARY_NEC,  ADDRESS, CITY,  STATEORPROVINCE ,  "  + 

"  COUNTRY,  POSTALCODE,  HOMEPHONE,  BIRTHDATE, "+ 

"  SERVICE_ENTRY_DATE ,  HOMETOWN,  HOMESTATE,  "  + 

"  LAST_UPDATED  )  VALUES  ”+ 
"(?,?,?,?,?,?,?,?,?,?,?,?,"+ 


pstmt . setstring  (  1 ,  sailorData . ssn) ; 
pstmt . setstring (  2,  sailorData.firstName); 
pstmt . setstring (  3,  sailorData .middleName)  ; 
pstmt . setstring (  4,  sailorData . lastName) ; 
pstmt . setstring (  5 ,  sailorData . sex) ; 
pstmt . setstring (  6,  sailorData . rankRate) ; 
'pstmt . setDate (  7,  dateRank); 
pstmt . setstring (  8 ,  sailorData . devicel ) ; 
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pstmt . setstring  (  9,  sailorData .device2) ; 
pstmt . setstring  {  10 ,  sailorData . devices ) ; 
pstmt . setstring  (  11,  sailorData .primaryNec) ; 
pstmt . setstring  (  12,  sailorData . secondaryNec) ; 
pstmt . setstring (  13 ,  sailorData . tertiaryNec) ; 
pstmt . setstring (  14 ,  sailorData . address ) ; 
pstmt . setstring  (  15,  sailorData. city) ; 
pstmt . setstring  (  16,  sailorData . state) ; 
pstmt . setstring  (  17 ,  sailorData . country) ; 
pstmt . setstring {  18,  sailorData. postalCode) ; 
pstmt . setstring  {  19,  sailorData. homePhone) ; 
pstmt . setDate (  20,  dateBirth) ; 
pstmt . setDate  (  21,  dateService) ; 
pstmt . setstring (  22,  sailorData. homeTown) ; 
pstmt . setstring  (  23,  sailorData. homeState) ; 
pstmt . setDate (  24 ,  dateUpdate) ; 
pstmt . executeUpdate ( ) ; 
pstmt .close () ; 
con. commit () ; 
if (debug  ==  true) { 

System. out .println( "Query  run  successfully"); 

} 

return  true; 

} 

catch (Exception  e) 

{  System. err.println( "System  Exception  in  addSailor"); 

System. err. println(e) ; 
throw  e; 

} 

} 

/** 

*  This  method  is  used  to  add  a  new  sea  mission  to 

*  the  database 

* 

*  ©param  seamission  struct  that  contains  all  applicable 

*  information 

* 

*  ©return  boolean 

*  ©exception  system  exception  to  catch  all  problems 

*/ 

public  boolean  adds eaMiss ion (  Navy . seamissionStruct  seamissionData) 

throws  Exception 

{ 

java..sql  .Date  dateMission  = 

java . sql .Date .valueOf (seamissionData . dateOf Mission)  ; 

try 

{ 

pstmt  =  con. prepares tatement ( 
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"  INSERT  INTO  SEA_MISSION{  SEA_MISSION_NDMBER, "+ 

"  DATE_OF_MISSION,TYPE_OF_MISSION,  EXERCISE_NAME  , "+ 
"  PIiATFORM_MODE,  PLATFORM_TyPE,  "  + 

"  PLATFORM_NUiyiBER,  PLATFORM_NAME  ,  "  + 

"  MISSION_AREA_ID)  "+ 

''  VALUES  (?,?,?,?,?,?,?,?,?)  '•); 

pstmt .  setstring  (  l,  seamissionData.missionNuniber)  ; 
pstmt . setDate (  2,  dateMission) ; 

pstmt . setstring (  3 ,  seamissionData . typeOf Mission)  ; 
pstmt . setstring (  4 ,  seamissionData . exerciseName)  ; 
pstmt . setstring (  5,  seamissionData. platf ormMode)  ; 
pstmt . setstring (  6,  seamissionData. platf ormType)  ; 
pstmt . setstring (  7,  seamissionData. platf ormNumber )  ; 
pstmt . setstring (  8,  seamissionData.platformName); 
pstmt . setstring ■(  9,  seamissionData. missionArea)  ; 
pstmt . executeUpdate ( ) ; 
pstmt . close { ) ; 
con. commit  0  ; 
if (debug  ==  true) { 

System. out. println( "Query  run  successfully"); 

•  } 

return  true; 

} 

catch (Exception  e) 

{  System. err.println( "System  Exception  in  addSeaMission"); 

System, err .print In (e) ; 
throw  e ; 

} 

} 


/** 

*  This  method  is  used  to  add  a  new  air  mission  to 

*  the  database 

* 

*  ©param  airmission  struct  that  contains  all  applicable 

*  information 

* 

*  ©return  boolean 

*  ©exception  system  exception  to  catch  all  problems 

*/ 

public  boolean  addAirMission (  Navy .airmissionS true t  airmissionData) 

throws  Exception 


{ 


j ava . sql . Timestamp  timeTakeOf f  = 

java.sql. Timestamp. valueOf (airmissionData .takeOffTime) ; 
j  ava . sql . Timestamp  timeLanding  = 

java. sql. Timestamp. valueOf  (airmissionData . landingTime)  ; 
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try 

{ 

double  durationTime  = 

(Double. valueOf  (airmissionData. duration) )  . doubleValue  ( )  ; 

pstmt  =  con. prepares tatement ( 

"  INSERT  INTO  FLIGHT_MISSION (  FLIGHT_MISSION_NtMBER, "+ 

"  DATE_TIME_OF_TAKE_OFF, "+ 

"  DATE_TIME_OF_LANDING,  DURATION,  PLATFORM_TYPE ,  "+ 

"  PLATFORM_NUMBER,  SQUADRON,  SQUADRON_CREW  , "+ 

"  STAGED_FROM _ BASE_,  STAGED_FROM _ CITY_, "+ 

"  STAGED_FROM _ COUNTRY_,  TYPE_OF_MISSION,  "  + 

"  EXERCISE_NAME, ”+ 

"  MISSION_AREA_ID,  TRACK_ID  )  "+ 

"  VALUES 

pstmt. setstring (  1,  airmissionData.missionNumber); 

pstmt . setTimes tamp (  2,  timeTakeOff) ; 

pstmt . setTimestamp (  3,  timeLanding) ; 

pstmt . setDouble (  4,  durationTime); 

pstmt. setstring (  5,  airmissionData.platformType); 

pstmt. setstring (  6,  airmissionData. platformNuraber) ; 

pstmt . setstring (  7,  airmissionData. squadron) ; 

pstmt. setstring (  8,  airmissionData . squadronCrew) ; 

pstmt . setstring (  9,  airmissionData. base ) ; 

pstmt . setstring (  10,  airmissionData.city); 

pstmt . setstring (  11,  airmissionData . country)  ; 

pstmt . setstring (  12,  airmissionData.typeMission); 

pstmt. setstring (  13,  airmissionData. exerciseName) ; 

pstmt . setstring (  14,  airmissionData. missionArea) ; 

pstmt . setstring {  15,  airmissionData . trackid) ; 

pstmt . executeUpdate ( ) ; 

pstmt . close ( ) ; 

con. commit () ; 

if (debug  ==  true) { 

System. out. println( "Query  run  successfully"); 

} 

return  true; 

} , 

catch (Exception  e) 

{  System. err .println( "System  Exception  in  addAirMission" ) ; 

System. err. println(e) ; 
throw  e; 

} 

} 
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/** 

*  This  method  is  used  to  modify  department  information  in 

*  the  database 

* 

*  @param  department  struct  that  contains  all  applicable 

*  information 

* 

*  ©return  boolean 

*  ©exception  system  exception  to  catch  all  problems 

*/ 

public  boolean  changeDeptInfo (  Navy . departmentStruct  departmentData) 

throws  Exception 

try 

{ 

pstmt  =  con. prepares tat ement ( 

"UPDATE  DEPARTMENT  SET  "  + 

"TITLE  =?,*'  + 

"TELEPHONE  =  ?  , 

"EMAIL  =  ?  , "+ 

”DEPARTMENT_HEAD_SSN  =  ?  ,  "  + 

”DEPARTMENT_CHIEF_SSN  =  ?  "  + 

"WHERE  DEPARTMENT_ID  =  ?  "); 

pstmt . setstring (  1,  departmentData. title) ; 
pstmt . setstring (  2,  departmentData.telephone); 
pstmt . setstring (  3,  departmentData. email) ; 
pstmt .setstring {  4,  departmentData .headSsn) ; 
pstmt .setstring (  5,  departmentData. chief Ssn) ; 
pstmt .setstring (  6,  departmentDa t a. department Id )  ; 
pstmt . executeUpdate ( ) ; 
pstmt. close {) ; 
con . commit ( ) ; 
if (debug  ==  true) { 

System. out .println( "Query  run  successfully") ; 

} 

return  true; 

} 

catch (Exception  e) 

{  System.err.  print  In  ("System  Exception  in  changeDeptInfo"); 

System. err. print In (e) ; 
throw  e; 

} 

} 
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/icic 

*  This  method  is  used  to  modify  division  information  in 

*  the  database 

* 


*  ©param  division  struct  that  contains  all  applicable 

*  information 

* 


*  ©return  boolean 

*  ©exception  system  exception  to  catch  all  problems 
*/ 


public  boolean  changeDivisionInfo (Navy. divisionStruct  divisionData) 


{ 

try 

{ 

pstmt  =  con.prepareStatement ( 

"UPDATE  DIVISION  SET  "+ 
”COMMAND_ID  =  ?  ,  "+ 

"DEPARTMENT_ID  =?,»'  + 
"DIVISION_ID  =  ?  ,"+ 

"TITLE  =  ?  ,  "+ 

"TELEPHONE  =  ?  ,  ”  + 

"EMAIL  =  ?,"+ 
"DIVISION_OFFICER_SSN  =  ? 
"DIVISION_CHIEF_SSN  =  ?  "+ 
"WHERE  DIVISION_ID  ^  ?  "); 


throws  Exception 


pstmt . setstring (  1 , 
pstmt . setstring (  2 , 
pstmt . setstring (  3 , 
pstmt . setstring {  4 , 
pstmt . setstring (  5 , 
pstmt . setstring {  6 , 
pstmt . setstring (  7 , 
pstmt . setstring (  8 , 
pstmt . setstring (  9 , 


divisionData. commandid) ; 
divisionData. departmentid) ; 
divisionData. divisionid) ; 
divisionData. title) ; 
divisionData. telephone) ; 
divisionData, email) ; 
divisionData. headSsn) ; 
divisionData. chief Ssn) ; 
divisionData. divisionid) ; 


pstmt . executeUpdate ( ) ; 
pstmt  .  close  (  )  ; 
con . commit ( ) ; 
if (debug  ==  true) { 

System. out .println ( "Query  run  successfully"); 

} 

return  true; 

} 

catch (Exception  e) 

{  System. err.println( "System  Exception  in  changeDivisionInfo"); 
System. err .println (e) ; 
throw  e; 

} 

} 
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/** 

*  This  method  is  used  to  check  the  userName  and  password 

*  against  a  table  maintained  in  the  database  for  authorization 

* 

*  ©param  Strings  containing  the  userName,  and  password 

* 

*  ©return  boolean 

*  ©exception  none 
*/ 

pxiblic  boolean  getAuthorization (String  userName,  String  password) 

{ 

boolean  returnValue  =  false; 

String  resPassword  =  null; 
try 

{  . 

Vector  result  =  new  Vector (); 
pstmt  =  con.prepareStatement ( 

”  SELECT  PASSWORD  "  + 

"  FROM  AUTHORIZATION_TABLE  WHERE  NAME  LIKE  ?”  ); 
pstmt  .setstring  (1,  userName)  ; 
pstmt . execute ( ) ; 
rs  =  pstmt .getResultSet 0 ; 
while (  rs.next()){ 
resPassword  =  rs .getString (1) ; 

} 

pstmt  .close  0  ; 
con .  commit  ( )  ; 

if (resPassword. equals (password) ) { 
retumValue  =  true; 

} 

return  returnValue ; 

} 

catch (  Exception  e) 

{  System.err.println( "System  Exception  in  getAuthorization"); 
System. err .print In (e) ; 
return  false; 

} 

} 


/** 

*  This  method  is  used  to  return  the  family  member  data  of  a 

*  specific  sailor 

* 

*  ©param  Strings  containing  the  sailors  ssn,  and  last  name 

* 

*  ©return  family  member  info 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  Vector  getFamilyMembers (String  sailorSsn, 

String  sailorLastName) 
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throws  Exception 


{ 

try 

{ 

Vector  result  =  new  Vector (); 
pstmt  =  con. prepares tatement ( 

"  SELECT  SAILOR.RANK_RATE  ,  SAILOR  .  FIRS TNAME + 

»  SAILOR. LASTNAME,  "  + 

"  FAMILY_MEMBERS  .  FAMILy_MEMBER_SOCIAL_SECURITY_,  "  + 

"  FAMILY_ME]y[BERS  .  NAME ,  "  + 

"  CONVERT  ( CHAR  { 12 )  ,FAMILY_MEMBERS.BIRTHDATE,  107)  AS  "  + 

"  DATEX,"+ 

”  FAMILY_MEMBERS  .  SEX ,  + 

"  FAMILY_MEMBERS  .  SAILOR__SOCIAL_SECURITY_NI3MBER  "  + 

"  FROM  SAILOR  INNER  JOIN  FAMILY_MEMBERS  ON  »  + 

”  SAILOR. SOCIAL_SECURITY_NUMBER  =  »+ 

"  FAMILY_MEMBERS .  SAILOR_SOCIAL_SECURITY_NUMBER  WHERE  "-f 
"  (SAILOR. LASTNAME  LIKE  ?  OR 

»  FAMILY_MEMBERS  .  SAILOR_SOCIAL_SECURITY_NUMBER  LIKE»*-f 
"  ?  )  ORDER  BY  FAMILY_MEMBERS.BIRTHDATE”) ; 

pstmt . setstring (  1 ,  sailorLastName) ; 
pstmt . setstring (  2 ,  sailorSsn) ; 
pstmt . execute ( ) ; 
rs  =  pstmt .getResultSet 0 ; 
while (rs .next () ) 

{ 

Navy . familydescStruct  family  =  new  Navy . familydescStruct ( ) ; 

family. rank  =  checkstring (rs .getString (1) ) ; 

family. firstName  =  checkstring (rs .getString (2) ) ; 

family. las tName  =  checkstring (rs .getString (3) ) ; 

family .memberSsn  =  checkstring  (rs  .getString  (4)  ) / 

family. memberName  =  checkstring  (rs  .getString  (5)  )  ; 

family .memberBirth  =  checkString(rs.getString(6)); 

family  .memberSex  =  checkstring  (rs  .getString  (7)  )  ; 

family .ememberSailorSsn  =  checkstring (rs .getString (8) ) ; 

result .addElement (family) ; 

if (debug  ==  true) { 

System,  out.  print  In  (family,  rank  +  «  «+  family .  firstName  +  "  " 

+  family . las tName  +  ”  ”+  family .memberSsn  +  "  ”  + 

family  .memberName  +  ”  »  +  family  .memberBirth  +  »  "  + 
family,  member  Sex  +  "  "  +  family .  ememberSailorSsn  ); 

} 

} 

pstmt  .close  ()  ; 
con . commit ( ) ; 
return  result; 

} 

catch (  Exception  e) 

{  System. err .println ( "System  Exception  in  getFamilyMembers"); 
System. err. print In (e) ; 
throw  e; 
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} 

} 

/** 

*  This  method  is  used  to  query  the  database  for  a  specific 

*  sailors  spouse 

* 

*  ©param  Strings  containing  the  sailors  ssn,  and  last  name 

* 

*  ©return  spouse  info 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  Vector  getSpouse (String  sailorSsn,  String  sailorLastName) 

throws  Exception 

{ 

try 

{ 

Vector  result  =  new  Vector (); 
pstmt  =  con. prepares tatement ( 

"  SELECT  SAILOR. RANK_RATE  ,  SAILOR . FIRSTNAME ,  "  + 

"  SAILOR. LASTNAME,  "+ 

"  SPOUSES  .  SPOUSE_SOCIAL_SECURITY_NUMBER ,  "  + 

"  SPOUSES. SPOUSE_NAME,  »+ 

"  SPOUSES  .  SPOUSE_DATE_OF_BIRTH ,  "  + 

"  SPOUSES . SPOUSE_GENDER ,  " + 

"  SPOUSES  .  SAILOR_SOCIAL_SECURITy_NUMBER  "  + 

”  FROM  SAILOR  INNER  JOIN  SPOUSES  ON  ”+ 

"  SAILOR.  SOCIAL_SECURITY_NUMBER  ="  + 

"  SPOUSES  .  SAILOR_SOCIAL_SECURITY_NUiyiBER  WHERE  "  + 

”  (SAILOR. LASTNAME  LIKE  ?  OR  "+ 

"  SPOUSES  .  SAILOR_SOCIAL_SECURITY_NUMBER  LIKE  ?  )  "  )  ; 

pstmt . setstring {  1 ,  sailorLastName) ; 

pstmt . setstring (  2,  sailorSsn); 

pstmt . execute ( ) ; 

rs  =  pstmt  .getResultSet  0  ; 

while  (  rs.next{)){ 

Navy.  spousedescStruct  spouse  =  new  Navy.spousedescStruct  ()  ; 

spouse. rank  =  checkstring (rs . get St ring (1) ) ; 

spouse . firstName  =  checkstring (rs . get St ring (2) ) ; 

spouse. lastName  =  checkstring (rs . gets tring (3) ) ; 

spouse. spouseSsn  =  checkstring (rs . get String (4) ) ; 

spouse . spouseName  =  checkstring (rs .gets tring (5) ) ; 

spouse . spouseBirth  =  checkstring (rs .get String (6) )  ; 

spouse . spouseSex  =  checkstring (rs . get St ring (7) ) ; 

spouse. SailorSsn  =  checkstring (rs . get St ring (8) ) ; 

result .  addElement  ( spouse )  ; 
if (debug  ==  true) { 

System,  out.  print  In  (spouse,  rank  +  "  ”+  spouse .  firstName  +  "  " 
+  spouse .  lastName  +  ”  "+  spouse .  spouseSsn  + 
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tf  It 


II  n 


} 

} 

pstmt  .close  ()  ; 
con. commit  ()  ; 
return  result; 

} 


+  spouse . spouseName  + 
spouse . spouseBirth  +  ”  "  + 
"  "  +  spouse .SailorSsn); 


^- 

spouse . spouseSex 


catch (  Exception  e) 

{  System.err.println( "System  Exception  in  getSpouse"); 
System.err .print In (e) ; 
throw  e; 


*  This  method  is  used  to  query  the  database  for  a  specific 

*  sailors  leave  data 

* 


*  ©param  Strings  containing  the  sailors  ssn,  and  last  name 

* 


*  ©return  leave  info 


*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  Vector  getLeaveData (String  sailorSsn,  String  sailorLastName) 

throws  Exception 

{ 

try 

{ 

Vector  result  =  new  Vector (); 


pstmt  =  con.prepareStatement ( 

"  SELECT  SAILOR .  RAJTK_RATE  ,  SAILOR .  FI RSTNAME,  "  + 

"  SAILOR. LASTNAME,  "+ 

"  LEAVE  .  SOCIAL_SECURITY__NUMBER ;  "  + 

"  LEAVE  .  LEAVE_CONTROL_NUMBER ,  "  + 

"  LEAVE  .  TYPE_OF_LEAVE ,  LEAVE  .  DATE_OF_DEPARTURE ,  "  + 

"  LEAVE. DATE_OF_RETXJRN  «  + 

"  FROM  SAILOR  INNER  JOIN  LEAVE  ON  "  + 

"  SAILOR.  SOCIAL_SECURITY_NUMBER  ="  + 

"  LEAVE  .  SOCIAL_SECURITY__NUMBER  WHERE  "  + 

"  { SAILOR. LASTNAME  LIKE  ?  OR  "+ 

"  SAILOR.  SOCIAL_SECURITY_NUMBER  LIKE"  + 

"  ?  )  ORDER  BY  LEAVE.DATE_OF_DEPARTURE") ; 


pstmt . setstring (  1,  sailorLastName) ; 
pstmt . setstring (  2,  sailorSsn) ; 
pstmt . execute ( ) ; 
rs  =  pstmt .getResultSet {) ; 
while (rs .next () ) 


{ 
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Navy.leavedescStruct  leave  =  new  Navy. leavedescStruct () ; 

leave . rank  =  checkstring (rs .getString (1) ) ; 

leave . firstName  =  checkstring (rs. getString (2) ) ; 

leave . lastName  =  checkstring ( rs . getString ( 3 ) ) ; 

leave . leaveSsn  =  checkstring (rs .getString (4) ) ; 

leave . controlNumber  =  checkstring (rs . getString ( 5 ) ) ; 

leave . typeOf Leave  =  checkstring (rs. getString (6) ) ; 

leave . dateDepart  =  checkstring (rs .getString (7) ) ; 

leave . dateReturn  =  checkstring (rs .getString (8) ) ; 

result .addElement (leave  ); 

if (debug  ==  true) { 

System. out. println (leave. rank  +  "  "+  leave. firstName  +  "  "  + 
leave . lastName  +  "  "+  leave. leaveSsn  +  "  "  + 
leave. controlNumber  +  "  "  +leave . typeOf Leave  + 

"  "  +  leave .  dateDepart  +  "  '■  +  leave .  dateReturn) 

} 

} 

pstmt. close ( ) ; 
con. commit () ; 
return  result; 

} 

catch (  Exception  e) 

{  System. err. println ("System  Exception  in  getLeaveData"); 

Sys tem. err. println (e) ; 
throw  e; 

} 

} 


/** 

*  This  method  is  used  to  query  the  database  for  a  specific 

*  sailors  PRT  data 

* 

*  ©param  Strings  containing  the  sailors  ssn,  and  last  name 

*  ©return  PRT  info 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  Vector  getPrtResults (String  sailorSsn,  String  sailorLastName) 

throws  Exception 

try 

{ 

Vector  result  =  new  Vector (); 
pstmt  =  con.prepareStatement ( 

"  SELECT  SAILOR.RANK_RATE  ,  "+ 

"  SAILOR. FIRSTNAME,  SAILOR . LASTNAME ,  ”+ 

"  PRT_DATA.COMMAND_ID,  "+ 

"  PRT_DATA.PRT_IDENTIFIER,  "+ 

"  PRT_DATA.SOCIAL_SECURITY_NOMBER,  "+ 

"  PRT_DATA. HEIGHT  ,  "  + 

"  PRT_DATA. WEIGHT,  PRT_DATA . PUSHUPS  , "+ 
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"  PRT__DATA.SITUPS  ,  ”  + 

"  PRT_DATA.RUN_TIME  ,  PRT__DATA .  PRT_DATE  ,  ”  + 

”  PRT_DATA.  STATUS  ”  + 

"  FROM  SAILOR  INNER  JOIN  PRT__DATA  ON  "  + 

”  SAILOR. SOCIAL_SECURITy_NUMBER  ="+ 

"  PRT_DATA.SOCIAL_SECURITy_NUMBER  WHERE  »+ 

"  ( SAILOR. LASTNAME  LIKE  ?  OR  »+ 

"  SAILOR. SOCIAL_SECURITy_NUMBER  LIKE"+ 

»  ?  )  ORDER  By  PRT_DATA.PRT_DATE  "); 

pstmt.  setstring  (  1,  sailorLastName)  ; 

pstmt. setstring (  2,  sailorSsn) ; 

pstmt . execute ( ) / 

rs  =  pstmt .getResultSet {)  ; 

while { rs . next ( ) ) 

{ 

Navy.prtdescStruct  prt  =  new  Navy  .prtdescStruct  ( )  ; 
prt.rank  =  checkstring (rs .getString (1) ) ; 
prt  .firstName  =  checkstring  (rs  .getString  (2)  )  ; 
prt.lastName  =  checkstring  (rs  .getString  (3) )  ; 
prt .  commandid  =  checkstring  (rs  .getString  (4) )  ; 
prt.prtid  =  checkString(rs.getString(5) ) ; 
prt.prtSsn  =  checkstring (rs .getString (6) ) ; 
prt. height  =  checkstring (rs .getString (7) ) ; 
prt. weight  =  checkstring (rs. getString (8) ) ; 
prt. pushups  =  checkstring (rs .getString (9) ) ; 
prt.sitUps  =  checkString(rs.getString(10) ) ; 
prt.runTime  =  checks tring(rs. gets t ring ( 11) )  ; 
prt.prtDate  =  checkstring (rs .getString (12) ) ; 
prt. status  =  checkstring (rs. getString (13) ) ; 
result .addElement (prt  )  ; 
if  (debug  ===  true)  { 

System.out.println (prt.rank  +  "  "+  prt . f irstName  +  ”  "  + 
prt.lastName  +  "  "+prt. commandid  +""+ 
prt.prtid  +  "  ”  +prt,prtSsn  +  ”  ’•  +  prt. height  + 
*'  ”  +  prt. weight  +  "  ”+  prt. pushups  +"  ”  + 
prt.sitUps  +"  "  +prt . rxinTime  +"  "+prt .prtDate  + 

”  "  +  prt . status  ) ; 

} 

} 

pstmt .  close  0  ; 
con . commit ( ) ; 
return  result; 

} 

catch (  Exception  e) 

{  System,  err .  print  In  ("System  Exception  in  getLeaveData"); 

System. err. print In (e) ; 
throw  e; 

} 

} 
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/** 

*  This  method  is  used  to  query  the  database  for  a  specific 

*  sailors  total  days  deployed 

* 

*  ©param  Strings  containing  the  sailors  ssn,  last  name, 

*  and  start/stop  dates 

* 

*  ©return  total  days  deployed 

*  ©exception  system  exception  to  catch  all  problems 

*/ 

public  Vector  getDaysDeployed (String  sailorSsn,  String 

sailorLastName,  String  startDate, 
String  stopDate) 
throws  Exception 


java. sql .Date  dateBegin  =  java.sql.Date.valueOf(startDate); 
java. sql. Date  dateEnd  =  java. sql. Date. valueOf (stopDate) ; 

try 

{ 

Vector  result  =  new  Vector (); 
pstmt  =  con.prepareStatement ( 

"SELECT  DISTINCT  TAD . TANGO_NUMBER , " + 

"  TAD . DATE_OF_DEPARTURE ,  "+ 

"  SAILOR. RANK_RATE,  "+ 

"  SAILOR. FIRSTNAME, "+ 

"  SAILOR. LASTNAME,  "+ 

"  COMMAND_INFORMATION.COMMAND_NAME,  "+ 

"  TAD_MASTER. TITLE,  "+ 

"  TAD.DATE_OF_ARRIVAL_AT_DESTINATION,  "+ 

"  TAD.DATE_OF_DEPARTURE_FROM_DESTINA, "+ 

"  TAD . DESTINATION  COMMAND  AS  COMMAND "+ 

"  FROM  "+ 

"  TAD_MASTER  INNER  JOIN  TAD  INNER  JOIN  "+ 

"  SAILOR  INNER  JOIN  BILLET_OCCUPATION  "+ 

"  INNER  JOIN  COMMAND_INFORMATION  ON  "  + 

"  BILLET_OCCUPATION.COMMAND_ID  =  "+ 

"  COMMAND_INFORMATION.COMMAND_ID  ON  "+ 

"  SAILOR. SOCIAL_SECURITy_NUMBER  =  "+ 

"  BILLET_OCCUPATION.SOCIAL_SECURITY_NUMBER  ON  "+ 

"  TAD.MEMBER_SOCIAL_SECURITY_NUMBER  =  "+ 

"  SAILOR. SOCIAL_SECDRITY_NUMBER  ON  "+ 

"  TAD_MASTER . CONFERENCE_TRAINING_ID_CODE  =  "+ 

"  TAD . TAD_ID_CODE  "+ 

"  WHERE  "+ 

"  (SAILOR. LASTNAME  LIKE  ?  OR  "+ 

"  SAILOR. SOCIAL_SECDRITY_NUMBER  LIKE  ?  )  AND  "+ 

"  TAD . DATE_OF_DEPARTURE  BETWEEN  ?  AND  ?  "+ 

"  AND  TAD . TANGO_NUMBER  =  TAD . TANGO_NUMBER  "+ 

"  GROUP  BY  "+ 

"  TAD . TANGO_NaMBER , " + 
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”  SAILOR .  RANK_RATE ,  ”  + 

”  SAILOR. FIRSTNAME, »+ 

*'  SAILOR .  LASTNAME ,  "  + 

"  COMMAND__INFORiyiATION .  COMMAND^NAME ,  "  + 

"  TAD_MASTER. TITLE, "+ 

”  TAD .  DATE_OF_ARRI VAL_AT_DESTINATION ,  »  + 

"  TAD .  DATE__OF_DEPARTURE_FROM_DESTINA ,  ”  + 

»  TAD .  DESTINATION _ COMMAND^ ,  ”  + 

"  TAD.DATE_OF_DEPARTURE  "  + 

"  ORDER  BY  ”+ 

"  TAD.DATE_OF_DEPARTURE,  ”  + 

"  TAD .  TANGO_Nl}MBER  " )  ; 

pstmt . set String (  1,  sailorLastName) ; 

pstmt . setstring (  2 ,  sailorSsn) ; 

pstmt .setDate (  3,  dateBegin) ; 

pstmt .setDate (  4,  dateEnd) ; 

pstmt . execute ( ) ; 

rs  =  pstmt.getResultSetO; 

while  (rs  .next  0  ) 

{ 

Navy,  deployment  Struct  deploy  =  new  Navy  .deployment  Struct  {)  ; 
deploy . tangoNumber  =  checkstring (rs .getString (1) ) ; 
deploy. dateDepart  =  checkstring (rs .getString (2) ) ; 
deploy. rankRate  =  checkString(rs.getString(3)); 
deploy. firs tName=  checkstring (rs .getString (4 ) ) ; 
deploy. las tName  =  checkString(rs.getString(5)); 
deploy. commandName  =  checkstring (rs .getString (6) ) ; 
deploy. title  =  checkstring (rs .getString (7) ) ; 
deploy .da teAr rival  =  checkstring (rs .getString (8) ) ; 
deploy .dateDeparture  =  checkstring (rs .getString  (9) ) ; 
deploy . comm  =  checkstring (rs .getString  (10) ) ; 
result .addElement (deploy) ; 
if (debug  ==  true) { 

System,  out  .print In  (deploy .  tangoNumber  +  "  '*  + 

deploy . dateDepart  +"  "  +  deploy . rankRate  + 

"  "+  deploy .  firs  tName  +»»*»+  deploy .  lastName  + 

”  ”  +deploy. commandName  +  ”  '*  +  deploy. title  + 

"  *'  +  deploy. dateArrival  +  "  ”  + 
deploy. dateDeparture  +”  "+  deploy. comm) ; 

} 

} 

pstmt .close ()  ; 
con. commit () ; 
return  result; 

} 

catch (  Exception  e) 

{  System. err .println ( "System  Exception  in  db  getDaysDeployed" ) 
System. err .print In  (e) ; 
e .print StackTrace ( ) ; 
throw  e ; 

} 
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} 


*  This  method  is  used  to  query  the  database  for  minor  property 

*  data 

* 

*  ©param  String  containing  the  command  ID 

* 

*  ©return  property  list  info 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  Vector  getPropertyList (String  commandid)  throws  Exception 

{ 

try 

{ 

Vector  result  =  new  Vector  () ; 
pstmt  =  con.prepareStatement  ( 

"  SELECT  Cdiyn^AND_INFOiy^TION.COiyiMAND_N^  ”  + 

”  PROPERTIES_LISTING . PROPERTY^ID , " + 

"  PROPERTIES_LI STING . PROPERTy_DE SCRIPT ION,  " + 

"  CONVERT  (CHAR  (12)  ,  "  AS  DATEX,  ”  + 

"  CONVERT ( CHAR ( 12 )  ,  PROPERTIES_LISTING . PRICE  ,  107  )  "  + 

"  AS  PRICE,  ”  + 

"  SAILOR.RANK__RATE,  SAILOR .  FIRSTNAME ,  SAILOR .  LAS TNAME  "  + 

"  FROM  "+ 

”  COMMAND_INFORMATION  INNER  JOIN  "  + 

"  PROPERTIES_LISTING  INNER  JOIN  SAILOR  ON"  + 

"  PROPERTIES_LISTING.SUBCUSTODIED  =  "  + 

"  SAILOR .  SOCIAL_SECURITy_NaMBER  ON  "  + 

"  COMMAND_INFORMATION.COMMAND_ID  =  "  + 

'  ”  PROPERTIES_LI STING.  COMMAND_ID  WHERE "  + 

"  PROPERTIES__LISTING.COMMAND_ID  =  ?"  + 

"  AND  PROPERTIES_LISTING.DISPOSAL__DATE  ”  + 

"  IS  NULL  "+ 

"  ORDER  BY  "+ 

"  PROPERTIES_LISTING.PROPERTY_ID  "); 

pstmt . setstring {  1 ,  commandid) ; 
pstmt . execute ( ) ; 
rs  pstmt  .getResultSet  0  ; 
while  (rs .  next  ( ) ) 

{ 

Navy .propertydescStruct  propdesc  =  new  Navy.propertydescStruct () 
propdesc .  commandName  =  checkstring  (rs . getString  (1)); 
propdesc. propertyld  =  checkString(rs.getString(2)); 
propdesc. propertyDesc  =  checkstring (rs. gets tring (3) ) ; 
propdesc, dateOf Purchase  =:  checkstring  (rs  .getString  (4)  )  ; 
propdesc. price  =  checkstring (rs .getString (5) ) ; 
propdesc . rank  =  checkString(rs.getString(6)); 
propdesc, firstName  =  checkString(rs,getString(7)); 
propdesc . lastName  =  checkstring (rs .getString (8) ) ; 
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result . addElement (propdesc  ) ; 
if (debug  ==  true) { 

System.out  .println  (propdesc. commandName  +  "  "  + 
propdesc.  propertyld  + 

"  "  +  propdesc .propertyDesc  +  ”  ”+ 
propdesc .dateOf Purchase  + 

”  "  +  propdesc .price  +  ”  "  + 
propdesc .rank  +  "  "  + 
propdesc. firstName  + 

"  ”  +  propdesc. lastName) ; 

} 

} 

pstmt.closeO  ; 
con . commit ( ) ; 
return  result; 

} 

catch (  Exception  e) 

{  System. err.println( "System  Exception  in  getPropertyList"); 
System. err .println (e) ; 
throw  e; 

} 

} 


/** 

*  This  method  is  used  to  query  the  database  for  a  specific 

*  commands  demographic  data 

* 


*  ©param  Strings  containing  the  command  ID,  and  gender  desired 

* 


*  ©return 

*  ©exception 
*/ 

ptiblic  Vector 
{ 

try 

{ 


command  demographic  info 

system  exception  to  catch  all  problems 

getComDemByGender (String  commandid,  String  sex) 

throws  Exception 


Vector  result  =  new  Vector (); 


pstmt  =  con.prepareStatement ( 

”  SELECT  COiyny[Airo_INFORMATION.COMMAND_NAME,  "  + 

"  COUNT(*)  AS  NUMBERX,"+ 

"  CONVERT  (CHAR  (12)  ,  GETDATEO  ,107)  AS  DATEZ  "  + 

"  FROM  SAILOR  INNER  JOIN  BILLET_OCCUPATION  "  + 

"  INNER  JOIN  COMMAND_INFORMATION  ON"  + 

"  BILLET_OCCUPATION.COMMAND_ID  =  "  + 

"  COMMAND_INFORMATION.COMMAND_ID  ON  "  + 

”  SAILOR .  SOCIAL_SECURITy_NUMBER  =  "  + 

”  BILLET_OCCUPATION.  SOCIAL_SECURITY_NUMBER"  + 

”  WHERE  (SAILOR.  SEX  LIKE  ?  )  AND  "  + 

‘  ”  BILLET_OCCUPATION.ACTUAL_DATE_OF_DEPARTURE  IS  NXHiL  AND 

”  BILLET  OCCUPATION.  COMMAND  ID  =  ?  "  + 


"  + 


178 


"  GROUP  BY  COMMAlSnD_INFORMATION.COMMAM)_NAME  "); 

pstmt .setstring (  1,  sex); 
pstmt. setstring {  2,  commandid) ; 
pstmt . execute ( ) ; 
rs  =  pstmt .getResultSet 0  ; 
while (rs .next ( ) ) 

{ 

Navy. demographicSt rue t  demographic  = 

new  Navy.  demographicStruct  0  ; 
demographic .  commandName  =  checkString(rs.getString(l)); 
demographic,  number  =  checkString(rs.getString{2)); 
demographic.dat ex  =  checkstring  (rs  .getSt ring  (3)  )  ; 
result . addElement (demographic)  ; 
if (debug  ==  true) { 

System.out.println (demographic. commandName  +  "  "  + 
demographic. number+  "  ”  + 
demographic. datex  ); 

} 

} 

pstmt  .close  0  ; 
con.  commit  ()  ; 
return  result; 

} 

catch (  Exception  e) 

{  System. err.println( "System  Exception  in  getComDemByGender"); 
System. err .print In (e) ; 
throw  e; 

} 

} 


/** 

*  This  method  is  used  to  query  the  database  for  a  specific 

*  commands  demographic  data  by  NEC  type 

* 

*  ©param  String  containing  the  command  ID,  and  3  strings 

*  containing  3  separate  NEC  types 

* 

*  ©return  command  demographic  NEC  info 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  Vector  getComDemByNec (String  commandid,  String  necl. 

String  nec2,  String  nec3) 
throws  Exception 

{ 

try 

{ 

Vector  result  =  new  Vector ( ) ; 
pstmt  =  con.prepareStatement ( 

"  SELECT  C0MI'1AND_INF0RMATI0N.C0MMAND_NAME,  "  + 

"  COUNT (*)  AS  NUMBERX,"+ 
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"  CONVERT (CHAR (12) ,  GETDATE()  ,107)  AS  DATE2  "  + 

"  FROM  SAILOR  INNER  JOIN  BILLET_OCCUPATION  "+ 

"  INNER  JOIN  COMMAND_INFORMATION  ON"+ 

"  BILLET_OCCUPATION.COMMAND_ID  =  "+ 

"  COMMAND_INFORMATION . COMMAND_ID  ON  "+ 

"  SAILOR. SOCIAL_SECURITY_NUMBER  =  "+ 

"  BILLET_OCCUPATION . SOCIAL_SECURITy_NUMBER " + 

"  WHERE  (SAILOR. PRIMARY_NEC_DESIGNATOR  LIKE  ?  OR"+ 

"  SAILOR. SECONDARY_NEC  LIKE  ?  OR  "+ 

"  SAILOR . TERTIARY_NEC  LIKE  ?  )  AND  "+ 

"  BILLET_OCCUPATION.ACTUAL_DATE_OF_DEPARTURE  IS  NULL  AND  "  + 
"  BILLET_OCCUPATION.COMMAND_ID  =  ?  "+ 

"  GROUP  BY  COMMAND_INFORMATION.COMMAND_NAME")  ; 

pstmt. setstring (  1,  necl) ; 
pstmt.setString(  2,  nec2) ; 
pstmt.setString(  3,  nec3) ; 
pstmt. setstring (  4,  commandid) ; 
pstmt . execute ( ) ; 
rs  =  pstmt .getResultSet 0 ; 
while (rs .next  0 ) 

{ 

Navy . demographics truct  demographic  = 

new  Navy.demographicStruct 0 ; 
demographic.  commandName  =  checkString(rs.getString(l)); 
demographic. number  =  checkString(rs.getString(2)); 
demographic. datex  =  checkstring (rs .getString (3) )  ; 
result . addElement (demographic) ; 
if (debug  ==  true) { 

Sys tern. out .println (demographic. commandName  +  *'  "  + 
demographic .number+  ”  ”  + 
demographic .datex) ; 

} 

} 

pstmt .  close  0  ; 
con . commit ( )  ; 
return  result; 

} 

catch (  Exception  e) 

{  System. err.println( "System  Exception  in  getComDemByGender"); 
System,  err  .println  (e)  ; 
throw  e; 

} 

} 
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/** 

*  This  method  is  used  to  query  the  database  for  a  specific 

*  commands  demographic  data  based  on  a  specific  rank 

* 

*  ©param  Strings  containing  the  command  ID,  and  paygrade 

* 

*  ©return  command  demographic  info 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

pxiblic  Vector  getComDemByRank (String  commandid.  String  payGrade) 

throws  Exception 

{ 

try 

{ 

Vector  result  =  new  Vector () ; 
pstmt  =  con.prepareStatement ( 

"  SELECT  COMMMro_INFORMATION.COMMAlC»_NAME,  "  + 

"  COUNT(*)  AS  NUMBERX, "+ 

"  CONVERT  (CHAR  (12)  ,  GETDATEO  ,107)  AS  DATEZ  "  + 

"  FROM  SAILOR  INNER  JOIN  BILLET_OCCUPATION  "+ 

"  INNER  JOIN  COMMAND_INFORMATION  ON"+ 

"  BILLET_OCCUPATION.COMMAND_ID  =  ’’  + 

"  COMMAND_INFORMATION.COMMAND_ID  ON  "+ 

"  SAILOR . SOCIAL_SECURITY_NaMBER  =  "+ 

"  BILLET_OCCUPATION.SOCIAL_SECURITy_NUMBER"+ 

"  WHERE  (SAILOR. PAYGRADE  =  ?  "+ 

''  AND  BILLET_OCCUPATION. ACTUAL_DATE_OF_DEPARTURE  IS"  + 

"  NULL  AND  "+ 

"  BILLET_OCCUPATION.COMMAND_ID  =  ?  ) "+ 

"  GROUP  BY  COMMAND_INFORMATION.COMMAND_NAME  ")  ; 

pstmt . setstring (  1,  payGrade) ; 
pstmt . setstring (  2 ,  commandid) ; 
pstmt . execute ( ) ; 
rs  =  pstmt .getResultSet 0  ; 
while ( rs . next ( ) ) 

{ 

Navy. demographics truct  demographic  = 

new  Navy.demographicStruct  0  ; 
demographic.  commandName  =  checkString{rs.getString(l)); 
demographic,  number  =  checkString(rs.getString(2)); 
demographic .  da  t  ex  =  checkstring  (rs  .get  St  ring  (3) )  ; 
result .  addElement  (demographic)  ; 
if (debug  ==  true) { 

Sys tern. out .println (demographic. commandName  +  »  »  + 
demographic .number+  »  "  + 
demographic . datex  ) ; 

} 

} 

pstmt  .close  0  ; 
con. commit  0  ; 
return  result; 
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} 

catch (  Exception  e) 

{  System. err.println( "System  Exception  in  getComDemByRank")  ; 
System. err .println (e) / 
throw  e ; 

} 

} 


*  This  method  is  used  to  query  the  database  for  a  specific 

*  commands  emergency  data 

* 

*  ©param  String  containing  the  command  ID 

* 

*  ©return  command  emergency  info 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  Vector  getEmergencyList (String  commandid)  throws  Exception 

{ 

try 

{ 

Vector  result  =  new  Vector ( ) ; 
pstmt  =  con.prepareStatement ( 

"  SELECT  COMMAND_INFOiy^TION.COMMAND_NAME,  "  + 

"  SUBSTRING  (DEPARTMENT .  DEPARTMENT_ID  ,  1,  2  )  AS  "  + 

"  DEPARTMENT_ID  ,  "  + 

"  SAILOR. RANK_RATE,  "  + 

"  SAILOR . FIRSTNAME , " + 

"  SAILOR .  LASTNAME ,  "  + 

"  SAILOR. HOMEPHONE  "+ 

"  FROM  COMMAND_INFORMATION  INNER  JOIN  "  + 

"  DEPARTMENT  INNER  JOIN  SAILOR  0N"  + 

"  DEPARTMENT. DEPARTMENT_HEAD_SSN  =  "  + 

"  SAILOR.  SOCIAL_SECURITY_NUMBER  0N"  + 

"  COMMAND_INFORMATION.COMMAND_ID  =  "  + 

"  DEPARTMENT. COMMAND_ID"  + 

"  WHERE  DEPARTMENT. COMMAND_ID  =  ?  "  + 

"  GROUP  BY  DEPARTMENT. DEPARTMENT_ID,  "  + 

"  COMMAND_INFORMATION .  COMMAND_NAME ,  "  + 

"  SAILOR. RANK_RATE,  SAILOR .  FIRSTNAME ,  "  + 

"  SAILOR. LASTNAME,  SAILOR . HOMEPHONE  "  + 

"  UNION  "+ 

"  SELECT  COMMAND_INFORMATION.COMMAND_NAME,  "  + 

"  SUBSTRING  (DEPARTMENT. DEPARTMENT_ID  ,  1,  2  )  "  + 

"  AS  DEPARTMENT_ID  ,  "  + 

"  SAILOR. RANK_RATE,  "  + 

"  SAILOR. FIRSTNAME, "+ 

"  SAILOR . LASTNAME , " + 

"  SAILOR. HOMEPHONE  "+ 

"  FROM  COMMAND_INFORMATION  INNER  JOIN  "  + 

"  DEPARTMENT  INNER  JOIN  SAILOR  ON"  + 
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"  DEPARTMENT. DEPARTMENT_CHIEF_SSN  =  "  + 

"  SAILOR. SOCIAL_SECURITy_NDMBER  ON  "+ 

"  COMMAND_INFORMATION.COMMAND_ID  =  "+ 

"  DEPARTMENT. COMMAND_ID"+ 

"  WHERE  DEPARTMENT . COMMAND_ID  =  ?  "+ 

"  GROUP  BY  "+ 

"  DEPARTMENT. DEPARTMENT_ID,  ■'  + 

"  COMMAND_INFORMATION.COMMAND_NAME,  "+ 

"  SAILOR. RANK_RATE,  SAILOR . FIRSTNAME ,  SAILOR.LASTNAME, "  + 

"  SAILOR.HOMEPHONE  "); 
pstmt . setstring (  1 ,  commandid) ; 
pstmt. setstring (  2,  commandid); 
pstmt . execute ( ) ; 
rs  =  pstmt .getResultSet 0 ; 
while { r s . next ( ) ) 

'{ 

Navy.emergencyStruct  emergency  =  new  Navy .  emergencyStruct  ()  ; 
emergency.  commanc2Name  =  checkString{rs.getString(l)); 
emergency . dept Id  =  checkstring (rs . getString (2)); 
emergency. rank  =  checkString(rs.getString(3)); 
emergency. firs tName  =  checkString(rs.getString(4)); 
emergency. las tName  =  checkstring (rs .getString (5) ) ; 
emergency. homePhone  =  checkString(rs.getString(6)); 

result .addElement (emergency)  ; 
if (debug  ==  true) { 

Sys  tern.  out.  print  In  (emergency.  commandName  +  "  ”  + 

emergency. dept Id+  ”  "  +  emergency. rank  +"  ”+ 
emergency. firs tName  +”  "+  emergency . lastName  + 
*'  "+  emergency. homePhone  )  7 

} 

} 

pstmt .  close  0  ; 
con. commit  0  ; 
return  result; 

} 

catch (  Exception  e) 

{  System. err.println( "System  Exception  in  getEmergencyList") ; 
System. err .print In (e) ; 
throw  e ; 

} 

} 
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f-k* 

*  This  method  is  used  to  query  the  database  for  data  regarding 

*  a  specific  seamission  based  on  platform  type,  type  of  mission, 

*  and  mission  area 

* 

*  ©param  Strings  containing  the  platform  type,  type  of 

*  mission,  area,  and  start /stop  dates 

* 

*  ©return  seamission  data 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  Vector  getSeaMissions (String  platform.  String  typeMission, 

String  missionArea,  String  startDate, 

String  stopDate) 
throws  Exception 


java. sql. Date  dateBegin  =  java.sql.Date.valueOf(startDate); 
j ava . sql . Date  dateEnd  =  j ava, sql. Date. valueOf  (stopDate)  ; 

try 

{ 

Vector  result  =  new  Vector (); 
pstmt  =  con. prepares tat ement ( 

"  SELECT  SEA_MISSION_NUMBER,  "+ 

»  CONVERT  (CHAR  (12),  SEA_MISSION. DATE_OF_MISSION,  107)"  + 

"  AS  DATEX,"  + 

"  TYPE_OF_MISSION,  EXERCISE_NAME ,  "  + 

"  PLATFORM^MODE,  PLATFORM__TyPE  ,  "  + 

”  PLATFORM_NUMBER,  PLATFORM__NAME ,  "  + 

"  SEA_MISSION.MISSION_AREA_ID  ,  DESCRIPTION  "  + 

"  FROM  SEA_MISSION  INNER  JOIN  MISS ION_AREA__DESCRIPT ION  ON  "  + 
"  SEA__MISSION.MISSION_AREA_ID  =  "  + 

"  MISSION_AREA_DESCRIPTION. MISSION_AREA_ID"  + 

”  WHERE  PLATFORM_TYPE  LIKE  ?  AND"  + 
n  TyPE_OF_MISSION  LIKE  ?  AND"  + 

"  SEA_MISSION.MISSION_AREA_ID  LIKE  ?  AND  "  + 

"  DATE_OF_MISSION  >=  ?  AND  "  + 

"  DATE_OF_MISSION  <  ?  "  + 

"  ORDER  BY  SEA_MISSION.DATE_OF_MISSION  "); 

pstmt .setstring (  1,  platform); 
pstmt .setstring (  2,  typeMission); 
pstmt .setstring (  3,  missionArea); 
pstmt .setDate (  4,  dateBegin); 
pstmt . setDate (  5 ,  dateEnd) ; 
pstmt . execute ( ) ; 
rs  =  pstmt .getResultSet 0 ; 
while (rs .next ( ) ) 

{ 

Navy . seamissiondescStruct  seamission  = 

new  Navy, seamissiondescStruct ( ) ; 
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seamission.missionNutnber  =  checkstring  (rs  .getString  (1)  )  ; 
seamission.dateOfMission  =  checkstring  (rs  .getString  (2)  )  ; 
seamission,  typeOfMission=  checkstring  (rs  .getString  (3) )  ; 
seamission.  exerName  =  checkstring  (rs  .getString  (4)  )  ; 
seamission. platformMode  =  checkstring  (rs  .getString  (5)  )  ; 
seamission.  platformType  =  checkString(rs.getString(6)); 
seamission.  plat  formNumber  =  checkString(rs.getString(7)); 
seamission. platformName  =  checkstring  (rs  .getString  (8)  )  ; 
seamission. missionAreald  =  checkstring  (rs  .getString  (9)  )  ; 
seamission.  description  =  checkString{rs.getString(lO)); 

result .addElement (seamission)  ; 

if (debug  ==  true) { 

System . out . println  ( seamission . missionNumber+  ” "  + 
seamission.dateOfMission  + 
n  It  +  seamission. typeOfMission+ 

”  ”  +  seamission. exerName  +  ”  "  + 
seamission. plat fo2nTiMode  +  ”  "  + 
seamission. platformType  +  "  ”  + 
seamission.  plat  formNumber  +  ’*  ”  + 
seamission. platformName  +  ”  "  + 
seamission. missionAreald  +"  "+ 
seamission. description)  ; 

} 

} 

pstmt . close ( ) ; 
con. commit ()  ; 
return  result; 

} 

catch (  Exception  e) 

{  System. err.println( "System  Exception  in  getSeaMissions" )  ; 
System.err.  print  In  (e)  ; 
throw  e; 

} 

} 

/** 

*  This  method  is  used  to  query  the  database  for  data  regarding 

*  seamissions  based  on  platform  type 

* 

*  ©param  Strings  containing  the  platform  type,  and  start /stop 

*  dates 

* 

*  ©return  seamission  data 

*  ©exception  system  exception  to  catch  all  problems 

*/ 

public  Vector  getSeaMissionsByPlatform (String  platform, 

String  startDate, 

String  stopDate) 
throws  Exception 
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{ 


java. sgl. Date  dateBegin  =  java.sql.Date.valueOf(startDate); 
java. sql. Date  dateEnd  =  java.sql.Date.valueOf (stopDate) ; 
try 
{ 

Vector  result  =  new  Vector (); 
pstmt  =  con.prepareStatement ( 

"  SELECT  SEA_MISSION_NUiyiBER,  "  + 

"  CONVERT  (CHAR  (12)  ,  SEA_MI SS ION. DATE_OF__MIS SION,  107)  AS  »  + 

”  DATEX,»+ 

»  TYPE_OF_MISSION,EXERCISE__NAME,  "  + 

"  PLATFORM__MODE,  PLATFORM_TYPE  ,  "  + 

”  PLATFORM__NUMBER,  PLATFORM___NAME ,  ”  + 

"  SEA_MISSION.MISSION_AREA_ID  ,  DESCRIPTION  "  + 

"  FROM  SEA_MISSION  INNER  JOIN  MISSION_AREA__DESCRIPTION  ON  ”  + 
"  SEA_MISSION.MISSION__AREA_ID  =  "  + 

«  MISSION__AREA_DESCRIPTION .  MISSION__AREA_ID "  + 

"  WHERE  PLATFORM_TYPE  LIKE  ?  AND”  + 

”  DATE_OF_MISSION  >=  ?  AND  "+ 

”  DATE_OF_MISSION  <  ?  »'  + 

”  ORDER  BY  PLATFORM__NUMBER,  DATE_OF_MISSION  "); 
pstmt . setstring (  1,  platform); 
pstmt . setDate (  2 ,  dateBegin) ; 
pstmt . setDate (  3,  dateEnd); 
pstmt . execute ( ) ; 
rs  =  pstmt .getResultSet 0 ; 
while (rs .next () ) 

{ 

Navy.seamissiondescStruct  seamission  = 

new  Navy.seamissiondescStruct 0 ; 
seamission. missionNumber  =  checkstring (rs .getString  (1) ) ; 
seamission. dateOfMission  =  checkstring (rs .getString  (2) ) ; 
seamission. typeOfMission=  checkstring (rs .getString (3) ) ; 
seamission. exerName  =  checkString(rs.getString(4)); 
seamission. plat formMode  =  checkString{rs.getString(5)); 
seamission. platformType  =  checkstring (rs .getString  (6) ) ; 
seamission. plat formNumber  =  checkstring  (rs  .getString  (7) )  ; 
seamission. plat formName  =  checkstring (rs .getString  (8) ) ; 
seamission. missionAreald  =  checkstring (rs .getString (9) ) ; 
seamission. description  =  checkstring (rs .getString (10) ) ; 

result . addElement (seamission)  ; 
if (debug  ==  true) { 

System. out .print In ( seamission. mi ssionNumber+  " ”  + 
seamission. dateOfMission  +  "  "  + 
seamission . typeOfMission+ 

"  ”  +  seamission. exerName  + 

»  II  +  seamission.  plat  formMode  +  ""  + 
seamission. platformType  +  *'  ”  + 
seamission. platformNumber  +  "  "+ 
seamission. platformName  +  "  ”  + 
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seamission.missionAreald  +”  "+ 
seamission. description) ; 

} 

} 

pstmt .close  0 ; 
con. commit () ; 
return  result; 

} 

catch (  Exception  e) 

{  System.err.println( "System  Exception  in 

getSeaMissionsByPlatform") ; 

System. err .println{e) ; 
throw  e ; 

} 

} 

/** 

*  This  method  is  used  to  query  the  database  for  data  regarding 

*  a  specific  seamission  based  on  area  data 

* 

*  ©param  Strings  containing  the  mission  area,  and  start /stop 

*  dates 

* 

*  ©return  seamission  area  data 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

piiblic  Vector  getSeaMissionsByArea (String  missionArea, 

String  startDate, 

String  stopDate)  throws  Exception 


java. sql. Date  dateBegin  =  java.sql.Date.valueOf (startDate) ; 
java. sql. Date  dateEnd  =  java. sql .Date. valueOf (stopDate) ; 

try 

{ 

Vector  result  =  new  Vector ( ) ; 
pstmt  =  con.prepareStatement ( 

"  SELECT  SEA_MISSION_NUMBER,  "+ 

"  CONVERT (CHAR (12) ,  SEA_MISSI0N.DATE_0P_MISS10N,  107)  AS  "  + 

"  DATEX, ”+ 

"  TYPE_0F_MISS10N, EXERCISE_NAME , " + 

"  PLATFORM_MODE ,  PLATFORM_TYPE  , "+ 

"  PLATFORM_NUMBER,  PLATFORM_NAME ,  "+ 

"  SEA_MISSION.MISSION_AREA_ID  ,  DESCRIPTION  "+ 

"  FROM  SEA_MISSION  INNER  JOIN  MISSION_AREA_DESCRIPTION  ON  "+ 
"  SEA_MISSION.MISSION_AREA_ID  =  "+ 

"  MISSION_AREA_DESCRIPTION.MISSION_AREA_ID"+ 

"  WHERE  "+ 

"  SEA_MISSION.MISSION_AREA_ID  LIKE  ?  AND  "+ 

"  DATE  OF  MISSION  >=  ?  AND  "+ 
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”  DATE_OF__MISSION  <  ?  "  + 

”  ORDER  BY  SEA_MISSION.DATE_OF_MISSION  "); 

pstmt . setstring (  1,  missionArea) / 
pstmt . setDate (  2 ,  dateBegin) ; 
pstmt . setDate (  3,  dateEnd) ; 
pstmt . execute ( ) ; 
rs  =  pstmt .getResultSet 0  ; 
while (rs.next {) ) 

{ 

Navy . seamissiondescStruct  seamission  = 

new  Navy. seamissiondescStruct 0 ; 
seamission. missionNumber  =  checkstring  (rs  .gets tring  (1)  )  ; 
seamission.  dateOf Mission  =  checkstring  (rs  .getString  (2)  )  ; 
seamission. typeOfMission=  checkString(rs.getString(3) )  ; 
seamission.  exerName  =  checkstring  (rs  .‘getString  (4)  )  ; 
seamission. platformMode  =  checkstring  (rs  .getString  (5)  )  ; 
seamission. platformType  =  checkstring  (rs  .getString  (6) )  ; 
seamission.  platformNumber  =  checkString(rs.getString(7)); 
seamission. platformName  =  checkstring  (rs  .getString  (8) )  ; 
seamission. missionAreald  =  checkstring  (rs  .getString  (9)  )  ;  • 
seamission.  description  =  checkString(rs.getString(10)); 

result  .addElement  (seamission)  ; 
if (debug  ==  true) { 

System,  out  .println  (seamission.  missionNumber+  + 
seamission. dateOf Mission  +  "  ”  + 
seamission. typeOfMission+ 

"  ”  +  seamission. exerName  +  »  «  + 
seamission. platformMode  +  "  "  + 
seamission. platformType  +  ”  "  + 
seamission. platformNumber  +  »  ”+ 
seamiss ion. plat formName  +  ”  ”  + 
seamission. missionAreald  +"  "+ 
seamission. description)  ; 

} 

} 

pstmt . close ( ) ; 
con. commit () ; 
return  result; 

} 

catch (  Exception  e) 

{  System. err.println( "System  Exception  in  getSeaMissionsByArea"); 
System. err .println (e) ; 
throw  e; 

} 

) 
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/** 

*  This  method  is  used  to  query  the  database  for  data  regarding 

*  a  specific  seamission  based  on  type  of  mission 

* 

*  ©param  Strings  containing  the  type  of  mission,  and  start/stop 

*  dates 

* 

*  ©return  seamission  data 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  Vector  getSeaMissionsByType (String  typeMission, 

String  startDate, 

String  stopDate)  throws  Exception 

{ 

j  ava . sql . Date  dateBegin  =  j  ava . sql . Date . valueOf { startDate ) ; 
java. sql .Date  dateEnd  =  java. sql .Date. valueOf (stopDate) ; 

try 

{ 

Vector  result  =  new  Vector () ; 
pstmt  =  con.prepareStatement ( 

"  SELECT  SEA_MISSION_NUMBER,  "+ 

”  CONVERT  (CHAR  (12)  ,  SEA_MISS ION. DATE_OF_MIS SION,  107)  AS  "  + 

"  DATEX,”+ 

”  TyPE_OF_MISSION,EXERCISE__NAME,  ”  + 

"  PLATFORM^MODE,  PLATFORM_TyPE  ,  "  + 

"  PLATFORM^NUMBER,  PLATFORM_NAME ,  "  + 

"  SEA_iyiISSION.MISSION_AREA_ID  ,  DESCRIPTION  ”  + 

"  FROM  SEA_MISSION  INNER  JOIN  MISSION_AREA_DESCRIPTION  ON  "  + 

”  SEA_MISSION.MISSION_AREA_ID  =  "  + 

'  "  MISSION_AREA_DESCRIPTION.MISSION_AREA_ID"  + 

«  WHERE  "+ 

It  TyPE_OF__MISSION  LIKE  ?  AND"  + 

"  DATE_OF_MISSION  >=  ?  AND  "  + 

”  DATE_OF_MISSION  <  ?  "  + 

”  ORDER  By  SEA_MISSION.DATE_OF__MISSION  ”); 

pstmt . setstring (  1,  typeMission); 
pstmt . setDate (  2 ,  dateBegin) ; 
pstmt . setDate (3 ,  dateEnd) ; 
pstmt . execute ( ) ; 
rs  pstmt.getResultSetO; 
while  (rs .  next  0  ) 

{ 

Navy . seamissiondescStruct  seamission  = 

new  Navy. seamissiondescStruct 0 ; 
seamission. missionNumber  =  checkstring  (rs  .getString  (1)  )  ; 
seamission.  dateOfMission  =  checkString(rs.getString(2)); 
seamission.  typeOf Miss ion=  checkstring  (rs  .getString  (3)  )  ; 
seamission.  exerName  =  checkstring  (rs  .getString  (4) )  ; 
seamission. plat formMode  =  checkstring  (rs  .getString  (5)  )  ; 
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seamission.platformType  =  checkstring (rs .gets tring  (6) )  ; 
seamission.platforniNumber  =  checkstring  (rs  .getString  (7)  )  ; 
seamission.platformName  =  checkString(rs.getString(8))/ 
seamission.missionAreald  =  checkstring (rs .getString  (9) )  ; 
seamission. description  =  checkstring (rs .getString (10) ) / 

result .addElement (seamission)  ; 
if (debug  =-  true) { 

System . out . pr int In  ( s eami s s i on . mi s s ionNumbe r +  ”  ”  + 
seamission. dateOfMission  +  "  ”  + 
seamission. typeOfMission+  **  "  + 
seamission. exerName  +  *'  ”  + 
s eami s sion.pl at formMode  +  ”  ”  + 
seamission.platformType  +  "  *'  + 
seamission. plat formNumber  +  *’  ”  + 
seamission.platformName  +  "  *'  + 
seamission.missionAreald  +"  "+ 
seamission . description)  ; 

} 

} 

pstmt . close () ; 
con. commit  ()  ; 
return  result; 

} 

catch (  Exception  e) 

{  System. err  .println  ( "System  Exception  in  getSeaMissionsByType" ) 
System. err .print In (e) ; 
throw  e; 

} 

} 


/** 

*  This  method  is  used  to  query  the  database  for  data  regarding 

*  a  specific  seamission  based  on  exercise  type 

* 

*  ©param  Strings  containing  the  exercise  name,  and  start /stop 

*  dates 

* 


*  ©return  seamission  exercise  data 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  Vector  getSeaMissionsByExercise (String  exerciseName, 

String  startDate, 
String  stopDate) 
throws  Exception 


java.sql.Date  dateBegin  =  java. sql .Date .valueOf (startDate)  ; 
java. sql. Date  dateEnd  =  java. sql .Date. valueOf (stopDate); 


try 
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{ 

Vector  result  =  new  Vector (); 
pstmt  =  con.prepareStatement ( 

"  SELECT  SEA_M1SSI0N_NUMBER,  "+ 

"  CONVERT  (CHAR  (12)  ,  SEA_MISS10N.DATE_0F_MISSI0N,  107)  AS  "  + 

"  DATEX, "+ 

"  TYPE_OF_MISSION,EXERCISE_NAME, "+ 

"  PLATFORM_MODE,  PriATFORM_TYPE  ,  ”  + 

"  PLATFORM_NUMBER,  PLATFORM_NAME ,  "+ 

"  SEA_MISSI0N.MISS10N_AREA_ID  ,  DESCRIPTION  "+ 

"  FROM  SEA_MISSION  INNER  JOIN  MISSION_AREA_DESCRIPTION  ON  "+ 
"  SEA_MISSION.MISSION_AREA_ID  =  "+ 

"  MISSION_AREA_DESCRIPTION.MISSION_AREA_ID"+ 

"  WHERE  "+ 

"  TYPE_OF_MISSION  LIKE  'EXERCISE'  AND"+ 

"  EXERCISE_NAME  LIKE  ?  AND  "+ 

"  DATE_OF_MISSION  >=  ?  AND  "+ 

"  DATE_OF_MISSION  <  ?  "+ 

"  ORDER  BY  EXERCISE_NAME,  DATE_OF_MISSION  "); 

pstmt. setstring (  1,  exerciseName) ; 
pstmt. setDate (  2,  dateBegin) ; 
pstmt . setDate ( 3 ,  dateEnd) ; 
pstmt . execute { ) ; 
rs  =  pstmt.getResultSetO; 
while (rs .next  0 ) 

{ 

Navy.seamissiondescStruct  seamission  = 

new  Navy.seamissiondescStruct  0  ; 
seamission.  missionNumber  =  checkString(rs.getString(l)); 
seamission. dateOfMission  =  checkstring (rs .get St ring (2) ) ; 
seamission. typeOfMission=  checkstring (rs .getString (3) ) ; 
seamission. exerName  =  checkString(rs.getString(4)); 
seamission. platforroMode  =  checkstring  (rs  .getString  (5)  )  ; 
seamission. platformType  =  checkstring  (rs  .getString  (6)  )  ; 
seamission.  platformNumber  =  checkString(rs.getString(7)); 
seamission. platformName  =  checkstring  (rs  . getString  (8 ))  ; 
seamission. missionAreald  =  checkstring (rs .getString (9) ) ; 
seamission. description  =  checkstring (rs .getString (10) ) ; 

result .addElement (seamission)  ; 
if (debug  ==  true) { 

System,  out  .println  (seamission  .missionNumber+  "  "  + 
seamission. dateOfMission  +  "  "  + 
seamission. typeOfMission+  "  "  + 
seamission.  exerName  +*'”  + 
seamission. plat formMode  +  "  ”  + 
seamission. plat foimiType  +  "  ”  + 
seamission. platformNumber  +”"+ 
seamission. platformName  +  "  "  + 
seamission. missionAreald  +"  "+ 
s eamission.de script ion)  ; 
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} 

} 

pstmt. close  ()  ; 
con . commit ( ) ; 
return  result; 


} 

catch (  Exception  e) 

{  System,  err,  print  In  ("System  Exception  in  getSeaMissionsByType"); 
System. err. printlnCe) ; 
throw  e; 

} 

} 


/** 

*  This  method  is  used  to  query  the  database  for  data  regarding 

*  a  specific  seamission  based  on  a  platform  name 

* 

*  ©param  Strings  containing  the  platform  name,  and  start /stop 

*  dates 

* 

*  ©return  platform  data 

*  ©exception  system  exception  to  catch  all  problems 

*/ 

pxiblic  Vector  getSeaMi sByPl at formName  (String  platform, 

String  startDate, 

String  stopDate) 
throws  Exception 

{ 

java.sql.Date  dateBegin  =  java.sql.Date.valueOf(startr)ate); 
j ava . sql . Date  dateEnd  =  j ava.sql. Date. valueOf (stopDate) ; 

try 

{ 

Vector  result  =  new  Vector {); 
pstmt  =  con.prepareStatement ( 

"  SELECT  SEA_MISSION_NUMBER,  "+ 

"  CONVERT  (CHAR  (12 )  ,  SEA_MI SS ION.  DATE_OF_MIS SION,  107)  AS  "  + 

"  DATEX, "+ 

tt  type_of_mission,exercise_name,  "  + 

"  platform_mode,  PLATF0RM_TYPE  ,"  + 

"  PLATF0RM_NUMBER,  PLATFORM_NAiyiE ,  "  + 

"  SEA_MISSI0N.MISSI0N_AREA_ID  ,  DESCRIPTION  "  + 

"  FROM  SEA_MISSION  INNER  JOIN  MISSION_AREA_DESCRIPTION  ON  "  + 
"  SEA_MISSION.MISSION_AREA_ID  =  "  + 

"  MISSION_AREA_DESCRIPTION.MISSION_AREA_ID"  + 

"  WHERE  "+ 

"  PLATFORM_NAME  LIKE  ?  AND  "  + 

"  DATE_OF_MISSION  >=  ?  AND  "+ 

”  DATE_OF_MISSION  <  ?  "  + 

"  ORDER  BY  PLATFORM_NAME,  DATE__OF_MISSION  "); 


192 


pstmt , setstring (  1, platform) ; 
pstmt . setDate (  2,  dateBegin) ; 
pstmt . setDate (3 ,  dateEnd) ; 
pstmt . execute ( ) ; 
rs  =  pstmt .getResultSet 0 ; 
while {rs.next () ) 

{ 

Navy.  seamissiondescStruct  seamission  = 

new  Navy. seamissiondescStruct 0 ; 
seamission. missionNumber  =  checkstring  (rs  .getString  (1)  )  ; 
seamission. dateOfMission  =  checkstring  (rs. gets tring  (2)  )  ; 
seamission.  typeOfMission=  checkstring  (rs  .getString  (3)  )  ; 
seamission. exerName  =  checkstring  (rs  .getString  (4)  );  ; 
seamission.  platformMode  =  checkString(rs.getString{5)); 
seamission. platformType  =  checkstring  (rs  .getString  (6)  )  ; 
seamission. plat formNumber  =  checkstring  (rs  .getString  (7) ) 
seamission. plat formName  =  checkstring  (rs  .getString  (8)  )  ; 
seamission. missionAreald  =  checkstring  (rs  .getString  (9)  )  ; 
seamission. description  =  checkstring  (rs  .getString  (10)  )  ; 

result  .addElement  (seamission)  ; 
if (debug  ==  true) { 

System,  out  .println  (seamission.  missionNumber+  " "  + 
seamission. dateOfMission  +  «  »  + 
seamission. typeOfMission+  "  ”  + 
seamission. exerName  +  "  ”  + 
seamission. platformMode  +  »  "  + 
seamission. platformType  +”"+ 
seamission. plat formNumber  +  ”  "+ 
seamission. platformName  +  "  ”  + 
seamission. missionAreald  +"  ”+ 
seamission. description)  ; 

} 

} 

pstmt .  close  ( )  ; 
con .  commit  ( )  ; 
return  result; 

} 

catch (  Exception  e) 

{  System. err.println( "System  Exception  in 

getSeaMisByPlatformName") ; 

System. err .println (e)  ; 
throw  e ; 

} 

} 
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* 

*  This  method  is  used  to  query  the  database  for  data  regarding 

*  airmissions 

* 


*  ©param  Strings  containing  the  squadron  name,  platform, 

*  type  mission,  mission  area  and  start/stop  dates 

* 


*  ©return  aiimiission  data 

*  ©exception  system  exception  to  catch  all  problems 
*/ 


public  Vector  getAirMissions (String  squadron.  String  platform, 

String  typeMission,  String  missionArea, 
String  startDate,  String  stopDate) 
throws  Exception 


{ 


j ava . sql . Date  dateBegin  =  java.sql.Date.valueOf(startDate); 
j ava . sql . Date  dateEnd  =  j ava. sql .Date. valueOf (stopDate) ; 

try 

{ 

Vector  result  =  new  Vector (); 
pstmt  =  con.prepareStatement ( 

"  SELECT  FLIGHT_MISSION__NUMBER,  DATE_TIME_OF_TAKE_OFF ,  "  + 

"  DATE_TIME_OF_LANDING ,  DURATION,  PLATFORM_TYPE ,  "  + 

"  PLATFORM_NUMBER,  SQUADRON,  SQUADRON_CREW ,  ”  + 

"  STAGED_FROM _ ^BASE_ ,  "  + 

”  STAGED_FROM _ CITY_,  STAGED_FROM _ COUNTRY^,  "  + 

”  TYPE_OF_MISSION, ”+ 

"  EXERCISE_NAME,  FLIGHT_MI S SION. MISS ION_AREA_ID,  TRACK_ID, 
"  DESCRIPTION  ”+ 

"  FROM  FLIGHT_MISSION  INNER  JOIN  MISSION_AREA_DESCRIPTION 
II  ON  "  + 

"  FLIGHT_MISSION.MISSION_AREA_ID  =  ”+ 

"  MIS S ION_AREA_DE S CRI PT I ON . MI S S I ON_AREA_ID "  + 

”  WHERE  SQUADRON  LIKE  ?  AND"  + 

"  PLATFORM_TYPE  LIKE  ?  AND  ”+ 

"  TYPE_OF_MISSION  LIKE  ?  AND»+ 

"  FLIGHT_MISSION.MISSION_AREA_ID  LIKE  ?  AND  *'  + 

"  DATE_TIME_OF_TAKE_OFF  >=  ?  AND  "  + 

"  DATE_TIME__OF_TAKE_OFF  <  ?  ”  + 

"  ORDER  BY  FLIGHT_MISSION.DATE_TIME_OF_TAKE_OFF  "); 
pstmt.setString(  1,  squadron); 
pstmt. setstring (  2,  platform); 
pstmt. setstring (  3,  typeMission); 
pstmt. setstring (  4,  missionArea); 
pstmt . setDate (  5 ,  dateBegin) ; 
pstmt . setDate (  6 ,  dateEnd) ; 
pstmt  .execute  0  ; 
rs  =  pstmt  .getResultSet  0  ;  , 
while  (rs  .next  0  ) 

{ 
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Navy.airmissiondescStruct  airmission  = 

new  Navy.airmissiondescStruct  {)  ; 
airmission. missionNumber  =  checkString(rs.getString(l)); 
airmission. dateTakeOff  =  checkstring (rs .getString  (2) )  ; 
airmission. dateLanding  =  checkString(rs.getString(3)); 
airmission. duration  =  checkString(rs.getString(4)); 
airmission. plat formType  =  checkString(rs.getString(5)); 
airmission. plat formNumber  =  checks t ring (rs. getString  (6 ) ) 
airmission. squadronid  =  checkstring (rs .getString  (7) )  ; 
airmission. squadronCrew  =  checkstring (rs . getString  (8) )  ; 
airmission. stageBase  =  checkstring (rs .getString (9) )  ; 
airmission. stageCity  =  checkString(rs.getString(lO)); 
airmission. stageCountry  =  checkstring (rs .getString  (11) ) ; 
airmission. typeOfMission  =  checkstring (rs .getString  (12) ) 
airmission. exerName  =  checkstring (rs .getString (13) )  ; 
airmission. missionAreald  =  checkstring  (rs  .getString  (14)  ) 
airmission. trackid  =  checkstring (rs .getString (15) )  ; 
airmission. description  =  checkstring (rs .getString  (16) )  ; 

result . addElement (airmission)  ; 
if (debug  ==  true) { 

System. out. println (airmission. missionNumber  +  "  "+ 
airmission. dateTakeOff +  "  ”  + 
airmission. dateLanding  +”  "+ 
airmission. duration  +  ”  "  + 
airmission. platformType  +  ”  "  + 
airmission. platformNumber  +”  ”+ 
airmission. squadronid  +  ”  "+ 
airmission. squadronCrew  +  "  "  + 
airmission. stageBase  +  ”  ”+ 
airmission. StageCity  +””+ 
airmission. StageCountry  +  ”  "  + 
airmission. typeOfMission  +  "  "+ 
airmission. exerName  +  ”  ”  + 
airmission. missionAreald  +  ”  ”+ 
airmission. trackid  +  n  n  + 
airmission. description  ) ; 

} 

} 

pstmt  .close  ()  ; 
con . commit ( )  ; 
return  result; 

} 

catch (  Exception  e) 

{  System,  err  .println  ("System  Exception  in  getAirMissions” ) 
System. err .println (e) ; 
throw  e; 

} 

} 
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*  This  method  is  used  to  query  the  database  for  data  regarding 

*  airmissions  by  a  specific  platform  number 

* 

*  ©param  Strings  containing  the  platform  number,  and  start /stop 

*  dates 

* 

*  ©return  airmission  platform  number  data 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  Vector  getAirMisByPlatformNo (String  platformNo, 

String  startDate, 

String  stopDate) 
throws  Exception 


java. sql. Date  dateBegin  =  java.sql.Date.valueOf(startDate); 
j ava . sgl . Date  dateEnd  =  java . sql .Date .valueOf (stopDate) ; 

try 

{ 

Vector  result  =  new  Vector (); 
pstmt  =  con. prepares tatement { 

"  SELECT  FLIGHT_MISSION_NUMBER,  DATE_TIME_OF_TAKE_OFF,  "  + 

"  DATE_TIME_OF_LANDING ,  DURATION ,  PLATFORM_TYPE ,  "  + 

"  PLATFORM_NUMBER,  SQUADRON,  SQUADRON_CREW,  "+ 

"  STAGED__FROM _ BASE_,  ”  + 

”  STAGED^FROM _ CITY_,  STAGED__FROM _ COUNTRY^,  ”  + 

"  TYPE_OF_MISSION,  ”  + 

”  EXERCISE_NAME,  FLIGHT_MISSION . MISSION_AREA_ID ,  TRACK_ID,.  »  + 
”  DESCRIPTION  "+ 

”  FROM  FLIGHT_MISSION  INNER  JOIN  MISSION_AREA_DESCRIPTION 
n  ON  "  + 

”  FLIGHT_MISSION.MISSION_AREA_ID  =  "  + 

”  MISSION_AREA_DESCRIPTION.MISSION_AREA_ID’'  + 

"  WHERE  PLATFORM_NUMBER  LIKE  ?  AND”+ 

”  DATE_TIME_OF_TAKE_OFF  >=  ?  AND  "  + 

"  DATE_TIME_OF_TAKE_OFF  <  ?  ”+ 

”  ORDER  BY  FLIGHT_MISSION.DATE_TIME_OF__TAKE_OFF  ”); 
pstmt. setstring (  1,  platformNo); 
pstmt .setDate{  2,  dateBegin); 
pstmt . setDate (  3 ,  dateEnd) ; 
pstmt . execute ( ) ; 
rs  =  pstmt .getResultSet 0 ; 
while (rs.next {) ) 

{ 

Navy. airmissiondescStruct  airmission  = 

new  Navy  .airmissiondescStruct  0  ; 
airmission. missionNumber  =  checkstring (rs .getString (1) ) ; 
airmission. dateTakeOff  =  checkstring (rs .getString (2) ) ; 
airmission. dateLanding  =  checkstring (rs .getString (3) ) ; 
airmission. duration  ==  checkstring  (rs  .getString  (4)); 
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airmission.platformType  =  checkstring  (rs  .gets tring  (5)  )  ; 
airmission.platforitiNumber  =  checkstring  (rs .  getString  (6)  )  ; 
aiirmission.squadronld  =  checkString(rs.getString(7)); 
airmission.sguadronCrew  =  checkstring (rs .getString (8) )  ; 
airmission.stageBase  =  checkstring (rs .getString  (9) ) ; 
airtnission.  stageCity  =  checkstring  (rs  .getString  (10)  )  ; 
airmission . stageCountry  =  checkstring (rs .getString (ll) )  ; 
airmission.typeOf Mission  =  checkstring  (rs  .getString  (12)  )  ; 
airmission. exerName  =  checkstring (rs.getString( 13) ) ; 
airmission. missionAreald  =  checkstring  (rs  .getString  (14)  )  ; 
airmission. trackid  =  checkstring (rs .getString  (15) )  ; 
airmission. description  =  checkstring (rs .getString  (16) ) ; 

result .addElement (airmission) ; 
if (debug  ==  true) { 

System. out .println (airmission. missionNumber  +  "  "+ 
airmission. dateTakeOff+  »  "  + 
airmission. dateLanding  +"  "+ 
airmission. duration  +  "  + 

airmission.platformType  +  ”  "  + 
airmission. platformNumber  +"  ”  + 
airmission. sguadronid  +  »»  »  + 
airmission.sguadronCrew  +  "  "  + 
airmission.stageBase  +  + 

airmission. StageCity  +  ”  "  + 
airmission. StageCountry  +"»+ 
airmission. typeOf Mission  +  "  "+ 
airmission. exerName  +  ”  »  + 
airmission. missionAreald  +  ”  "  + 
airmission. trackid  +  »  n  ^ 

airmission. description  ) ; 

} 

} 

pstmt .close () ; 
con.  commit  0  ; 
return  result; 

} 

catch (  Exception  e) 

{  System. err.println( "System  Exception  in  getAirMisByPlatform" )  ; 

System,  err  .println  (e)  ; 

throw  e ; 

} 

} 
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*  This  method  is  used  to  query  the  database  for  data  regarding 

*  airmissions  by  a  specific  mission  area 

* 

*  ©param  Strings  containing  the  mission  area,  and  start/stop 

*  dates 


* 


*  ©return 

*  ©exception 
*/ 

public  Vector 
{ 


airmission  area  data 

system  exception  to  catch  all  problems 

getAirMisByArea (String  missionArea,  String  startDate, 
String  stopDate)  throws  Exception 


java.sql.Date  dateBegin  =  java.sql.Date.valueOf(startDate); 
j ava . sql . Date  dateEnd  =  java. sql. Date. valueOf (stopDate) ; 

try 

{ 

Vector  result  =  new  Vector ( ) ; 
pstmt  =  con.prepareStatement ( 

"  SELECT  FLIGHT_MISSION_NDMBER,  DATE_TIME_OF_TAKE_OFF ,  "+ 

"  DATE_TIME_OF_LANDING,  Dt^ATION,  PLATFORM_TYPE,  "  + 

"  PLATFORM_NUMBER,  SQUADRON,  SQUADRON_CREW ,  "  + 

"  STAGED  FROM  BASE  , "+ 

"  STAGED  FROM  CITY  ,  STAGED_FROM _ COUNTRY_,  "+ 

"  TYPE_OF_MISSION, "+ 

"  EXERCISE_NAME,  FLIGHT_MISSION. MISSION_AREA_ID ,  TRACK_ID,  "+ 
"  DESCRIPTION  "+ 

"  FROM  FLIGHT_MISSION  INNER  JOIN  MISSION_AREA_DESCRIPTION  "+ 

It  ON  "  + 

"  FLIGHT_MISSION.MISSION_AREA_ID  =  "+ 

"  MISSION_AREA_DESCRIPTION. MISSION_AREA_ID’'  + 

"  WHERE  "+ 

"  FLIGHT_MISSION.MISSION_AREA_ID  LIKE  ?  AND  "+ 

"  DATE_TIME_OF_TAKE_OFF  >=  ?  AND  "  + 

"  DATE_TIME_OF_TAKE_OFF  <  ?  "+ 

"  ORDER  BY  FLIGHT_MISSION.DATE_TIME_OF_TAKE_OFF  "); 

pstmt . setstring (  1,  missionArea) ; 
pstmt. setDate(  2,  dateBegin); 
pstmt . setDate (  3,  dateEnd); 
pstmt . execute ( ) ; 
rs  =  pstmt.getResultSetO; 
while ( rs. next  0 ) 

{ 

Navy.airmissiondescStruct  airmission  = 

new  Navy.airmissiondescStruct 0 ; 
airmission. missionNumber  =  checkstring (rs .getString (1) ) ; 
airmission. dateTakeOff  =  checkstring (rs.getString (2) ) ; 
airmission . dateLanding  =  checkstring (rs . getString ( 3 ) ) ; 
airmission. duration  =  checkstring (rs .getString (4)); 
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airmission.platformType  =  checkstring  (rs  .get String  (5)  )  ; 
airmission.platformNumber  =  checkstring (rs.getString (6) )  ; 
airmission.  squadronid  =  checkString(rs.getString(7)); 
airmission.  squadronCrew  =  checkstring  (rs  .getString  (8)  )  ; 
airmission. stageBase  =  checkstring (rs .getString (9)  )  ; 
airmission.  stageCity  ==  checkstring  (rs  .getString  (10)  )  ; 
airmission.  stageCountry  =  checkString(rs.getString(ll)); 
airmission.  typeOfMission  =  checkString(rs.getString(12)); 
airmission. exerName  =  checks tring(rs.getString(  13)  )  ; 
airmission. missionAreald  =  checkstring  (rs  .getString  (14) )  ; 
airmission.  trackid  =  checkstring  (rs  .getString  (15) )  ; 
airmission. description  =  checkstring  (rs  .getString  (16)  )  ; 

result .  addElement  (airmission)  ; 
if (debug  ==  true) { 

System. out. println{airmission.missionNumber  +  *'  ”  + 
airmission. dateTakeOff+  "  "  + 
airmission. dateLanding  +"  "+ 
airmission. duration  +  *'  "  + 
airmission.platformType  +  "  "  + 
airmission.platformNumber  +”  ”+ 
airmission. squadronid  +  "  ”+ 
airmission. squadronCrew  +  "  "  + 
airmission. stageBase  +  »  »+ 
airmission. StageCity  +  "  "  + 
airmission. StageCountry  +””+ 
airmission. typeOfMission  +"”+ 
airmission. exerName  +  "  "  + 
airmission. missionAreald  +  "  "+ 
airmission. trackid  +  »  »  + 

airmission. description  ) ; 

} 

} 

pstmt .close () ; 
con.  commit  0  ; 
return  result; 

} 

catch (  Exception  e) 

{  System, err.println( "System  Exception  in  getAirMissions"); 
System. err. println(e) ; 
throw  e; 

} 

} 
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/** 

*  This  method  is  used  to  query  the  database  for  data  regarding 

*  airmissions  by  a  mission  type 

* 

*  ©param  Strings  containing  the  type  of  mission,  and  start/stop 

*  dates 

■k 

*  ©return  airmission  type  data 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  Vector  getAirMisByType (String  typeOfMission, 

String  startDate,  String  stopDate) 
throws  Exception 

{ 

java. sql. Date  dateBegin  =  java.sql.Date.valueOf(startDate); 
java. sql. Date  dateEnd  =  java. sql. Date. valueOf (stopDate); 


try 

{ 

Vector  result  =  new  Vector () ; 
pstmt  =  con.prepareStatement ( 

"  SELECT  FLIGHT_MISSION_NUMBER,  DATE_TIME_OF_TAKE_OFF ,  "+ 

"  DATE_TIME_OF_LANDING , DURATION ,  PLATFORM_TYPE , " + 

"  PLATFORM_NUMBER,  SQUADRON,  SQUADRON_CREW ,  "+ 

"  STAGED  FROM  BASE  , "+ 

"  STAGED_FROM _ CITy_,  STAGED  FROM  COUNTRY  ,  "+ 

"  TyPE_OF_MISSION, "+ 

"  EXERCISE_NAME ,  FLIGHT_MISSION.MISSION_AREA_ID ,  TRACK_ID, "+ 
"  DESCRIPTION  "+ 

"  FROM  FLIGHT_MISSION  INNER  JOIN  MISSION_AREA_DESCRIPTION  "  + 

It  ON  "  + 

"  FLIGHT_MISSION.MISSION_AREA_ID  =  "+ 

"  MISSION_AREA_DESCRIPTION . MISSION_AREA_ID " + 

"  WHERE  "+ 

"  TYPE_OF_MISSION  LIKE  ?  AND  "+ 

"  DATE_TIME_OF_TAKE_OFF  >=  ?  AND  "+ 

"  DATE_TIME_OF_TAKE_OFF  <  ?  "+ 

"  ORDER  BY  FLIGHT_MISSION.DATE_TIME_OF_TAKE_OFF  " ) ; 

pstmt . setstring (  1,  typeOfMission); 
pstmt . setDate (  2 ,  dateBegin) ; 
pstmt . setDate {  3,  dateEnd); 
pstmt . execute ( ) ; 
rs  =  pstmt.getResultSet () ; 
while (rs .next () ) 

Navy . airmissiondescStruct  airmission  = 

new  Navy .airmissiondescStruct 0 ; 
airmission. missionNumber  =  checkstring (rs .getstring  (1) )  ; 
airmission. dateTakeOff  =  checkString(rs.getString(2)); 
airmission. dateLanding  =  checkstring (rs.getString (3)); 
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airmission. duration  =  checkstring (rs.getString (4 )) ; 
airmission.platformType  =  checkstring (rs .getString (5) ) ; 
airmission. platformNumber  =  checkString(rs.getString(6) )  ; 
airmission. squadronid  =  checkstring (rs .getString (7) ) ; 
airmission. squadronCrew  =  checkString(rs.getString(8) )  ; 
airmission. stageBase  =  checkstring (rs .getString  (9) )  ; 
airmission. stageCity  =  checkstring (rs .getString (10) ) ; 
airmission. stageCoimtry  =  checkstring (rs .getString (11) ) ; 
airmission. typeOfMission  =  checkString{rs.getString(12) ) ; 
airmission. exerName  =  checkstring (rs .getString (13) ) ; 
airmission. missionAreald  =  checkstring (rs. getString ( 14) )  ; 
airmission. trackid  =  checkstring (rs .getString (15) ) ; 
airmission. description  =  checkstring (rs .getString (16) )  ; 

result .addElement (airmission) ; 
if (debug  ==  true) { 

System. out. println (airmission. missionNumber  +  "  "+ 
airmission. dateTakeOff+  "  "  + 
airmission. dateLanding  +"  "+ 
airmission. duration  +  "  "  + 
airmission.platformType  +  "  "  + 
airmission. platformNumber  +"  "+ 
airmission. squadronid  +  "  "+ 
airmission. squadronCrew  +  "  "  + 
airmission. stageBase  +  "  "+ 
airmission. StageCity  +  "  "  + 
airmission. stageCountry  +  "  "  + 
airmission. typeOfMission  +  "  "+ 
airmission.  exerName  +  + 

airmission. missionAreald  +  ”  "+ 
airmission. trackid  +  «  "  + 

airmission. description  ); 

} 

} 

pstmt. close {)  ; 
con.  commit  ()  ; 
return  result; 

} 

catch (  Exception  e) 

{  System. err.println( "System  Exception  in  getAirMissions"); 
System,  err.  print  In  (e)  / 
throw  e; 

} 

} 


201 


/** 

*  This  method  is  used  to  query  the  database  for  data  regarding 

*  airmissions  by  exercise 

* 


*  ©param  Strings  containing  the  exercise  name,  and  start /stop 

*  dates 

* 


*  ©return  airmission  exercise  data 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  Vector  getAirMisByExercise (String  exerciseName, 

String  startDate, 
String  stopDate) 
throws  Exception 


java. sql. Date  dateBegin  =  j ava.sql. Date. valueOf (startDate) ; 
java. sql. Date  dateEnd  =  java. sql. Date. valueOf (stopDate) ; 

try 

{ 

Vector  result  =  new  Vector (); 
pstmt  =  con. prepares t at ement ( 

"  SELECT  FLIGHT_MISSION__NUMBER,  DATE__TIME_OF_TAKE_OFF,  "  + 

"  DATE_TIME_OF_IiANDING ,  DURATION ,  PLATFORM_TYPE ,  "  + 

"  PLATFORM__NUMBER,  SQUADRON,  SQUADRON_CREW,  ”  + 

"  STAGED__FROM _ BASE_,  ”  + 

"  STAGED_FROM _ CITY^,  STAGED_FROM _ COUNTRY^,  "  + 

II  TYPE_0F_MISSI0N,  "  + 

»  EXERCISE_NAME,  flight__mission.mission_area_id,  TRACK_ID,  "  + 
"  DESCRIPTION  "+ 

"  FROM  FLIGHT_MISSION  INNER  JOIN  MISSION_AREA_DESCRIPTION  "  + 

11  ON  ”  + 

*'  FLIGHT_MISSION.MISSION_AREA_ID  =  "  + 

MISSION_AlREA_DESCRIPTION.MISSION_AREA___ID»  + 

”  WHERE  «+ 

"  TYPE_OF_MISSION  LIKE  'EXERCISE^  AND  ”+ 

”  EXERCISE_NAME  LIKE  ?  AND  ”  + 

”  DATE_TIME_OF_TAKE_OFF  >=  ?  AND  "  + 

«  DATE_TIME_OF_TAKE_OFF  <  ?  "+ 

»  ORDER  BY  FLIGHT_MISSION.DATE_TIME_OF_TAKE_OFF  "); 

pstmt . setstring (1,  exerciseName) ; 
pstmt. setDate(  2,  dateBegin); 
pstmt . setDate (  3,  dateEnd); 
pstmt . execute { ) ; 
rs  =  pstmt .getResultSet 0 ; 
while (rs.next () ) 

{ 

Navy.airmissiondescStruct  airmission  = 

new  Navy.airmissiondescStruct 0 ; 
airmission. missionNumber  =  checkstring (rs.getString(l)); 
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airmission.dateTakeOff  =  checkstring (rs .getString (2) )  ; 
airmission.dateLanding  =  checkstring (rs .gets t ring (3)  )  ; 
airmission. duration  =  checkstring (rs .getString (4)  )  ; 
airmission.platformType  =  checkString(rs.getString(5)); 
airmission. platformNumber  =  checkstring  (rs  .getString  (6) ) 
airmission.  squadronid  =  checkstring  (rs  .getString  (7)  )  ; 
airmission. squadronCrew  =  checkstring (rs .getString  (8)  )  ; 
airmiission.stageBase  =  checkstring (rs. gets tring (9)  )  ; 
airmission. stageCity  =  checkstring (rs .getString (10)  )  ; 
airmission. stageCountry  =  checkstring (rs .getString  (11)  )  ; 
airmission,  typeOfMission  =  checkstring  (rs  .getString  (12) ) 
airmission. exerName  =  checkstring (rs. gets tring ( 13)  ) ; 
airmission. missionAreald  =  checkstring  (rs  .getString  (14) ) 
airmission. trackid  =  checkstring (rs .getString (15)  )  ; 
airmission. description  =  checkString(rs.getString(16)); 

result .addElement (airmission) ; 
if (debug  =-  true) { 

System. out .println(airmission.missionNumber  +  ”  ”  + 
airmission. dateTakeOff+  ”  "  + 
airmission.dateLanding  +”  ”+ 
airmission. duration  +"”+ 
airmission.platformType  +  ”  "  + 
airmission. platformNumber  +”  "+ 
airmission. squadronid  +  "  "+ 
airmission. squadronCrew  +  ”  »  + 
airmission. stageBase  +  »  "+ 
airmission. StageCity  +  »  »•  + 
airmission. StageCountry  +""+ 
airmission. typeOfMission  +""+ 
airmission. exerName  +  "  "  + 
airmission. missionAreald  +  ”  "+ 
airmission. trackid  +  "  »'  + 

airmission. description  ) ; 

} 

} 

pstmt . close ( ) ; 
con. commit  0  ; 
return  result; 

} 

catch (  Exception  e) 

{  System.err.println( "System  Exception  in  getAirMissions") 
System. err .println (e) ; 
throw  e; 

} 

} 
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J-k-k 

*  This  method  is  used  to  query  the  database  for  data  regarding 

*  airmissions  by  a  specific  squadron 

* 


*  ©param  Strings  containing  the  squadron  name,  and  start/stop 

*  dates 

* 


*  ©return  airmission  squadron  data 

*  ©exception  system  exception  to  catch  all  problems 
*/ 

public  Vector  getAirMisBySquadron (String  squadronName , 

String  startDate, 
String  stopDate) 
throws  Exception 


java.sql.Date  dateBegin  ==  java . sql  .Date .valueOf  (startDate)  ; 
java. sql. Date  dateEnd  =  java.sql.Date. valueOf (stopDate) ; 

try 

{ 

Vector  result  =  new  Vector (); 
pstmt  =  con.prepareStatement ( 

”  SELECT  FLIGHT_MISSION_NUMBER,  DATE_TIME_OF_TAKE_OFF,  »  + 

”  DATE_TIME_OF_LANDING ,  DURATION ,  PLATFORiyi_TyPE ,  "  + 

"  PLATFORM_NUMBER,  SQUADRON,  SQUADRON__CREW ,  "  + 

”  STAGED_FROM _ BASE_,  "  + 

"  STAGED_FROM _ CITY_,  STAGED_FROM _ COUNTRY^,  "  + 

ti  TYPE^OF^MISSION,  "  + 

»  EXERCISE_NAME,  flight_mission.mission_area_id,  TRACK_ID,  "  + 
"  DESCRIPTION  *'  + 

'  "  FROM  FLIGHT_MISSION  INNER  JOIN  MISSION_AREA_DESCRIPTION 
If  ON  ”  + 

"  FLIGHT_MISSION.MISSION_AREA__ID  =  "  + 

»  MISSION_AREA_DESCRIPTION.MISSION_AREA_ID”  + 

"  WHERE  + 

»  SQUADRON  LIKE  ?  AND  ”+ 

"  DATE_TIME_OF_TAKE_OFF  >=  ?  AND  »  + 

"  DATE_TIME__OF_TAKE_OFF  <  ?  "  + 

"  ORDER  BY  FLIGHT_MISSION.DATE_TIME_OF_TAKE_OFF  ")  ; 

pstmt  .setstring  (  1,  squadronName)  ; 
pstmt . setDate (  2 ,  dateBegin) ; 
pstmt . setDate (  3 ,  dateEnd) ; 
pstmt . execute ( ) ; 
rs  =  pstmt .getResultSet 0 ; 
while (rs .next () ) 

{ 

Navy .airmissiondescStruct  airmission  = 

new  Navy. airmissiondescStruct 0 ; 
airmission. missionNumber  =  checkstring (rs .getString (1) ) ; 
airmission. dateTakeOff  =  checkstring (rs .getString (2)); 
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airmission.dateLanding  =  checkString(rs.getString(3)); 
airmission. duration  =  checkstring (rs .gets tring (4) ) ; 
airmission.platformType  =  checkstring (rs .getString (5) ) ; 
airmission. platformNumber  =  checkString(rs.getString(6)); 
airmission. squadronid  =  checkstring (rs .getString (7) ) ; 
airmission. squadronCrew  =  checkstring (rs .getString  (8) )  ; 
airmission. stageBase  =  checkstring (rs .getString (9) ) ; 
airmission. stageCity  =  checkstring (rs .getString (10) ) ; 
airmission. stageCountry  =  checkstring (rs .getString (11) )  ; 
airmission. typeOfMission  =  checkString(rs.getString(12)); 
airmission. exerName  =  checkstring (rs .getString (13) ) ; 
airmission. missionAreald  =  checkstring (rs .getString (14) )  ; 
airmission. trackid  =  checkstring (rs .getString (15) ) ; 
airmission. description  =  checkstring (rs. getString  (16) )  ; 

result . addElement (airmission) ; 
if (debug  ==  true) { 

System. out. println (airmission. missionNumber  +  " 
airmission. dateTakeOff+  ”  "  + 
airmission.dateLanding  +”  "+ 
airmission. duration  +  ”  "  + 
airmission.platformType  +  "  "  + 
airmission. platformNumber  +"  "+ 
airmission. squadronid  +”"+ 
airmission. squadronCrew  +  "  "  + 
airmission. stageBase  +  »  »+ 
airmission. StageCity  +  ”  ”  + 
airmission. StageCountry  +  "  "  + 
airmission. typeOfMission  +  "  "+ 
airmission. exerName  +  "  ”  + 
airmission, missionAreald  +  ”  ”+ 
airmission. trackid  +  »  «  + 

airmission. description  ); 

} 

} 

pstmt.  close  0  ; 
con . commit ( )  ; 
return  result; 

} 

catch (  Exception  e) 

{  System. err.println( "System  Exception  in  getAirMissions”)  ; 
System. err. println(e)  ; 
throw  e ; 

} 

} 
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f-ic-k 

*  This  method  is  used  to  query  the  database  for  data  regarding 

*  maintenance  data  of  a  specific  command 

* 


*  ©param  Strings  containing  the  command  ID,  department  ID 

*  and  the  start/stop  dates 

k 


*  ©return 

*  ©exception 
*/ 

public  Vector 


{ 


maintenance  data 

system  exception  to  catch  all  problems 

getMaintByCommand (String  commandid, 

String  departmentid. 

String  startDate,  String  stopDate) 

throws  Exception 


java. sql. Date  dateBegin  =  java.sql.Date.valueOfCstartDate); 
java. sql. Date  dateEnd  =  java. sql. Date. valueOf (stopDate) ; 

try 

{ 

Vector  result  =  new  Vector {) ; 
pstmt  =  con. prepares tatement  ( 

"  SELECT  COMMA]TO_INFORMATION.COMMAND_NAME,  •'  + 

"  PMS_DESCRIPTION. DESCRIPTION, 

”  MAINTENANCE  .  PERSON ,  MAINTENANCE  .  ITEM_ID ,  "  + 

"  MAINTENANCE  .  MAINTENANCE_NUMBER ,  ”  + 

"  CONVERT  (CHAR  (12 )  ,  MAINTENANCE.DATE_CONDUCTED,  107)  AS  »  + 
"  DATEX, ”+ 

”  MAINTENANCE. REPAIR_PRIORITY  ,  "  + 

«  MAINTENANCE. EMERGENCY_DESCRIPTION  ,  ”  + 

”  MAINTENANCE .  DEPARTMENT_ID ,  ”  + 

"  MAINTENANCE. HOURS _ ON_JOB  "  + 

"  FROM  COMMAND_INFORMATION  INNER  JOIN  PMS_DESCRIPTION  »  + 

”  INNER  JOIN  MAINTENANCE  ON"  + 

”  MAINTENANCE .  PMS_ITEM_NUMBER  =  "  + 

”  PMS_DESCRIPTION.PMS_ITEM_NUMBER  ON  »  + 

”  COMMAND_INFORMATION.COMMAND_ID  =  "  + 

"  MAINTENANCE .  COMMAND_ID  "  + 

”  WHERE  ”+ 

”  MAINTENANCE .  COMMAND_ID  =  ?  AND  ”  + 

”  MAINTENANCE. DEPARTMENT_ID  LIKE  ?  AND  ”  + 

"  MAINTENANCE. DATE_CONDUCTED  >  ?  AND  "  + 

"  MAINTENANCE .  DATE_CONDUCTED  <=  ?  ”  + 

"  ORDER  BY  MAINTENANCE. DATE_CONDUCTED,  ”  + 

”  MAINTENANCE  ;MAINTENANCE__NUMBER  »); 

pstmt . setstring (  1 ,  commandid) ; 
pstmt. setstring (  2,  departmentid) ; 
pstmt . setDate (  3 ,  dateBegin) ; 
pstmt .setDate (  4,  dateEnd); 
pstmt . execute ( ) ; 
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rs  =  pstmt.getResultSetO; 
while ( rs . next  0 ) 

{ 

Navy. commaintenanceStruct  maintenance  = 

new  Navy.  commaintenanceStruct  0  ; 
maintenance .  commandid  =:  checkstring  (rs  .getString  (1) )  ; 
maintenance. description  =  checkstring (rs .getString (2) ) ; 
maintenance. person  =  checkstring (rs .getString (3 )) ; 
maintenance . itemid  =  checkstring (rs .getString (4)  )  ; 
maintenance. maintNo  =  checkString(rs.getString(5)); 
maintenance .dateConduct  =  checkstring (rs .getString (6) ) ; 
maintenance . priority  =  checkstring ( rs . getString ( 7 ) ) ; 
maintenance . emergencyDesc  =  checkstring ( rs . getString (8)); 
maintenance. dept Id  =  checkstring (rs .getString (9) ) ; 
maintenance. hours  =  checkString(rs.getString(10)); 

result .addElement (maintenance) ; 
if (debug  ==  true) { 

Sys tern. out. println (maintenance. commandid  +  "  "  + 
maintenance . de script ion+  "  "  + 
maintenance . person  +  »  ”  + 
maintenance . itemid  +  "  ”  + 
maintenance. maintNo  +  ”  "  + 
maintenance . dateConduct  + "  " + 
maintenance . priority  +"”+ 
maintenance . emergencyDesc.  +  "  "  + 
maintenance. dept Id  +  "  "+ 
maintenance. hours  ) ; 

} 

} 

pstmt  .close  {)  ; 
con .  commit  (); 

System,  out  .println  ("Query  run  successfully”); 
return  result; 

} 

catch (  Exception  e) 

{  System. err .println ("System  Exception  in  getMaintByCommand") ; 
System. err .println (e) ; 
throw  e; 

} 

} 


/** 

*  This  method  is  used  to  query  the  database  for  data  regarding 

*  the  maintenance  of  a  specific  item 

* 

*  ©par am  String  containing  the  equipment  item 

* 

*  ©return  maintenance  data 

*  ©exception  system  exception  to  catch  all  problems 
*/ 
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p\iblic  Vector  getMaintByl tern  (String  item)  throws  Exception 

{ 

try 

{ 

Vector  result  =  new  Vector (); 

ps  tmt  =  con . prepares  tat ement ( 

"  SELECT  PMS_DESCRIPTION. DESCRIPTION,  "  + 

"  PROPERTIES__LISTING.  PROPERTY__DESCRIPTION,  ”  + 

"  MAINTENANCE  .  PERSON,  *’  + 

»  MAINTENANCE . ITEM_ID  , »+ 

"  MAINTENANCE  .  MAINTENANCE_NUMBER ,  »  + 

"  CONVERT  (CHAR  (12)  ,  MAINTENANCE .  DATE_CONDUCTED ,  107)  AS  "  + 
"  DATEX, "+ 

”  MAINTENANCE. REPAIR_PRIORITY  ,  "  + 

"  MAINTENANCE. EMERGENCY_DESCRIPTION  ,  "  + 

"  MAINTENANCE. DEPARTMENT_ID,  ”  + 

"  MAINTENANCE  .  HOURS _ ON_JOB  ”  + 

"  FROM  PROPERTIES_LISTING  INNER  JOIN  PMS_DESCRIPTION  '•  + 

»'  INNER  JOIN  MAINTENANCE  ON"  + 

"  MAINTENANCE .  PMS__ITEM_NUMBER  =  "  + 

"  PMS_DESCRIPTION.PMS_ITEM_NUMBER  ON  "  + 

"  PROPERTIES_LISTING.PROPERTY_ID  =  MAINTENANCE .  I TEM_ID  "  + 

"  WHERE  ”+ 

"  MAINTENANCE . ITEM_ID  =  ?  "+ 

"  ORDER  BY  MAINTENANCE. DATE_CONDUCTED  »); 

pstmt.setString{  1,  item) ; 
pstmt . execute ( ) ; 
rs  =  pstmt .getResultSet 0 ; 
while (rs .next () ) 

{ 

Navy .  itemmaintenanceStruct  queryitem  = 

new  Navy. itemmaintenanceStruct 0 ; 
queryitem. pmsDesc  =  checkstring  (rs .  getSt ring  (1)  )  ; 
queryitem. description  =  checkstring  (rs  .getString  (2) )  ; 
queryitem.  person  =  checkString(rs.getString(3)); 
queryitem.  itemid  =  checkstring  (rs  .getString  (4)  )  ; 
queryitem. maintNo  =  checkstring  (rs  .getString  (5)  )  ; 
queryitem .  dateConduct  =  checkstring  ( rs .  getString  (6)); 
queryitem. priority  =  checkstring  (rs  .getString  (7)  )  ; 
queryitem.  emergencyDesc  =  checkstring  (rs  .getString  (8) )  ; 
queryitem.  dept  Id  =  checkString(rs.getString(9)); 
queryitem. hours  -  checkstring (rs .getString (10) ) ; 

result  .addElement  (queryitem)  ; 
if (debug  ==  true) { 

System. out .println(queryitem. pmsDesc  +  "  "  + 
queryitem. descript ion+  "  ”  + 
queryitem. person  +"  ”+ 
queryitem.  itemid  +  "  *'  + 
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query! tern. maintNo  +  "  »  + 
query! tern. dateConduct  +"  ”+ 
query! tern. pr!or!ty  +  "  ”+ 
query!tem.eTnergencyDesc  +"”  + 
query!tem.deptld  +  ”  "+ 
query! tern. hours  ) ; 

} 

} 

pstmt.  close  0  ; 

con. comm! t  ()  ; 

Sys  tern.  out.  pr!nt  In  ("Query  run  successfully”); 

return  result; 

} 

catch (  Exception  e) 

{  System. err.pr!ntln( "System  Exception  In  getMalntByltem"); 

System. err .prlntln (e) ; 

throw  e; 

} 

} 

}//end  DBHelper. java 
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APPENDIX  D.  CLIENT  FILES 


This  appendix  provides  several  selected  excerpts  from  the  source  code  required 
for  the  Client  implementation.  The  client  side  has  a  total  of  85  classes,  therefore  for 
brevity  we  have  included  only  the  most  significant  classes  to  include:  Gui.java, 
CorbaBean.java,  AdminPanel,  CommandPanel,  OperationsPanel,  MaintenancePanel, 
BudgetPanel,  SwitchPanel,  WelcomePanel,  AddFamilyBean,  ChangeAddressBean, 
GetDaysDeployedBean,  GetDaysDeployedPanell,  and  GetDaysDeployedPanel2  classes. 
In  addition,  we  have  included  the  Gui.html  and  Guijar.html  files. 


// . - 

//  Filename 
//  Authors 
//  Date . 

//  Compiler 
// - 


Gui . j  ava 

Murat  Akbay  &  Steve  Lewis 
10/17/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


/** 

*  This  class  is  the  definition  for  the  main  applet  class  that 

*  holds  a  reference  to  all  of  the  components  that  are  used  by 

*  the  client  to  invoke  operations  on  the  CORBA  server 

*  ©authors  Murat  Akbay  &  Steve  Lewis 
*/ 


import 

import 

import 

import 

import 

import 


j  ava . awt . * ; 
java.  applet .  *  ; 
borland. jbcl . layout . * ; 
borland. jbcl . control . * ; 
com . sun . j  ava , swing . * ; 
j  ava . awt . event . * ; 


public  class  Gui  extends  JApplet  implements  ActionListener { 


CorbaBean  corbaBean ; 

AdminPanel  adminPanel; 

BudgetPanel  budgetPanel ; 

CommandPane 1  c ommandPane 1 ; 

MaintenancePanel  maintenancePanel ; 

OperationsPanel  operations Panel ; 

WelcomePanel  welcomePanel; 

SwitchPanel  switchPanel; 

XYLayout  xYLayoutl  =  new  XYLayoutO; 

JMenuBar  menubar  =  new  JMenuBar  ( )  ; 

JMenu  menu  =  new  JMenu  ( "MENU"  )  ; 

JMenuItem  iteml  =  new  JMenuItem("  Switch  Panel  ")  ; 
JMenuItem  item2  =  new  JMenuItem ("  Administration  ")  ; 
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JMenuItem  item3 
JMenuItem  iteTn4 
JMenuItem  items 
JMenuItem  items 
JMenuItem  item? 


new  JMenuItem  ("  Budget  Ec  Supply  ")  ; 
new  JMenuItem ( "  Command  " )  ; 

new  JMenuItem  (”  Maintenance  ") / 
new  JMenuItem  ("Operations  &  Trng.")/ 
new  JMenuItem ("  Welcome  "); 


JPanel  displayPanel  =  new  JPanelO; 
CardLayout  cardLayoutl  =  new  CardLayout ( ) ; 
boolean  authorized  =  false; 


/** 

*  This  method  is  used  by  the  browser  to  initialize  the  applet 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  none 
*/ 

public  void  initO  { 
try{ 

jblnit  0 ; 

} 

catch  (Exception  ex)  { 
ex.printStackTrace 0 ; 

} 


/** 

*  This  method  is  used  by  the  panels  to  set  the  authorization  of  the 

*  client 

* 

*  ©param  inValue  authorization  of  the  client 

*  ©return  void 

*  ©exception  none 
*/ 

void  setAuthorization (boolean  inValue) { 
authorized  =  inValue; 

} 


/*★ 

*  This  method  is  used  by  initO  to  initialize  the  panels 

* 

*  ©param  none 

*  ©return  void 

*  .©exception  default  Jbuilder  exception 
*/ 

private  void  jblnit ()  throws  Exception  { 
corbaBean  =  new  CorbaBean(this) ; 
xYLayoutl . setHeight (590) ; 
adminPanel  =  new  AdminPanel (this)  ; 
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budgetPanel  =  new  BudgetPanel (this) ; 

commandPanel  =  new  CommandPanel (this) ; 

maintenancePanel  =  new  MaintenancePanel (this) ; 

operationsPanel  =  new  OperationsPanel (this) ; 

welcomePanel  =  new  Wei comePanel (this) ; 

switchPanel  =  new  SwitchPanel(this); 

iteml.addActionListener  (this) ; 

item2 .addActionListener (this) ; 

items .addActionListener (this) ; 

item4. addActionListener (this) ; 

items. addActionListener (this) ; 

items . addActionListener  (this) ; 

item? .addActionListener (this) ; 

xYLayoutl . setWidth (790) ; 

menu . add ( iteml ) ; 

menu.add(item2) ; 

menu. add (items) ; 

menu . add ( i tem4 ) ; 

menu . add ( items ) ; 

menu. add (items) ; 

menu . add ( item? ) ; 

menubar . add (menu) ; 

setJMenuBar (menubar) ; 

setBackground (Color . lightGray) ; 

this .get Content Pane ( ) . setLayout (xYLayoutl) ; 

displayPanel . setLayout (cardLayoutl) ; 

displayPanel . add ( "Administration" ,  adminPanel) ; 

displayPanel . add ( "Budget ^Supply" ,  budgetPanel ) ; 

displayPanel . add ( "Command" ,  commandPanel) ; 

displayPanel . add ( "Maintenance " ,  maintenancePanel ) ; 

displayPanel . add ( "Operations&Trng" ,  operationsPanel) ; 

displayPanel . add ( "Welcome" ,  welcomePanel) ; 

displayPanel .add ("SwitchPanel" ,  switchPanel) ; 

cardLayoutl . show (displayPanel ,  "Welcome " ) ; 

this . getContentPane ( ) . add (displayPanel ,  new  XYConstraints ( S ,  S , 


/** 


*  This  method  is  used  by  the  browser  to  release  the  ORB 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  default  Jbuilder  exception 
*/ 

piiblic  void  stopO  { 
try{ 

corbaBean . releaseOb j  ect  (); 

System. err.println( "Released  the  orb") ; 

} 

catch (Exception  e) { 
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System. err .print In {” Could  not  release  the  orb") ; 

} 

} 

f-kic 

*  This  method  is  used  by  the  browser  when  the  user  interacts  with 

*  the  applet. 

* 

*  ©param  e  the  actionevent  generated  by  the  user 

*  ©return  void 

*  ©exception  none 
*/ 

public  void  actionPerformed (ActionEvent  e)  { 

String  command  =  e.getActionCommandO  ; 

if  (command,  equals  ( "Administration" )  &&  (authorized  ==  true  )){ 
cardLayoutl.show(displayPanel,  "Administration")  ; 

} 

else  if (command. equals ("Budget  &  Supply")  && 

(authorized  ==  true  ) ) { 

cardLayoutl.show(displayPanel,  "  Budget  ^Supply " )  ; 

} 

else  if (command. equals ("Command")  &&  (authorized  ==  true  )){ 
cardLayoutl . show (displayPanel , " Command" )  ; 

} 

else  if  (command,  equals  ("Maintenance")  &&  (authorized  ==  true  )){ 
cardLayoutl.  show  (displayPanel,  "Maintenance")  ; 

} 

else  if  (command. ecjuals  ("Operations  &  Trng.")  && 

(authorized  ==  true  ) ) { 

cardLayoutl.  show  (displayPanel,  "  Operations  &Trng" )  ; 

} 

else  if  (command. ec[uals  ("Switch  Panel")  &&  (authorized  ==  true)  )  { 
cardLayoutl.  show  (displayPanel,  "SwitchPanel")  ; 

} 

else  if (command. equals ( "  Welcome  ")  )  { 

setAuthorization (false) ; 
welcomePanel .nameField. setText ( " " ) ; 
we Icome Panel .pas swordField. setText ( " " )  ; 
showWelcome  0  ; 

} 

} 
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I  ** 

*  This  method  is  used  by  the  applet  to  display  the  AdminPanel 

* 

*  ©pararn  none 

*  ©return  void 

*  ©exception  none 
*/ 

public  void  showAdmin{){ 

cardLayoutl.show(displayPanel,  "Administration")  ; 

} 


*  This  method  is  used  by  the  applet  to  display  the 

*  Budget  &SupplyPanel 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  none 
*/ 

public  void  showBudget ( )  { 

cardLayoutl.show(displayPanel,  ” Budge t&Supply")  ; 

} 


/  ** 

*  This  method  is  used  by  the  applet  to  display  the  CommandPanel 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  none 
*/ 

public  void  showCommand  ( )  { 

cardLayoutl.show(displayPanel,  "Command”)  ; 

} 


/** 

*  This  method  is  used  by  the  applet  to  display  the 


*  MaintenancePanel 

*  ©param 

none 

*  ©return 

void 

*  ©exception 

none 

*/ 

public  void  showMaintenance ( ) { 

cardLayoutl.show(displayPanel,  "Maintenance")  ; 
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/** 

*  This  method  is  used  by  the  applet  to  display  the 

*  Operations&TrngPanel 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  none 
*/ 

public  void  showOperations ( ) { 

cardLayoutl .  show  (displayPanel ,  *’Operations&Trng"  )  ; 

} 


*  This  method  is  used  by  the  applet  to  display  the  WelcomePanel 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  none 
*/ 

public  void  showWelcome {) { 

cardLayoutl . show{displayPanel, "Welcome") ; 

} 


/** 

*  This,  method  is  used  by  the  applet  to  display  the  SwitchPanel 

* 

*  ©param  none 

*  ©return  •  void 

*  ©exception  none 
*/ 

public  void  showSwitch () { 

cardLayoutl.show(displayPanel, "SwitchPanel")  ; 

} 


} 
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// - 

//  Filename 
//  Authors 
//  Date 
//  Compiler 
// - 


CorbaBean . j  ava 

Murat  Akbay  &  Steve  Lewis 

10/17/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


import  j  ava . awt . * ; 
import  j ava. applet. *; 
import  com . sun . j  ava . swing . * / 


/** 

*  This  class  is  used  by  the  applet  to  get  a  reference  and  invoke 

*  methods  on  the  CORBA  server 

* 

*  ©authors  Murat  Akbay  &  Steve  Lewis 
*/ 

public  class  CorbaBean  { 


Navy . NavSecDispenser  myDispenser ; 
Navy . NavSec  myNavSec ; 


/** 

*  This  method  is  the  constructor  for  the  CorbaBean  class 

* 

*  ©param  com. sun. java. swing. Japplet  parent 

*  ©return  none 

*  ©exception  default  Exception  to  catch  all  errors 
*/ 

piiblic  CorbaBean  (com. stm.  java,  swing.  JApplet  parent)  { 
try  { 

jblnit  (parent)  ; 

} 

catch  (Exception  ex)  { 
ex . prints tackTrace ( ) ; 

} 

} 


/** 

*  This  method  is  used  get  a  reference  to  the  naming  service  and 

*  bind  to  the  CORBA  server  object 

* 

*  ©param  Applet  parent 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

private  void  jblnit (Applet  parent)  throws  Exception  { 
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try  { 

String []  args  =  null; 

//initialize  the  orb 

org.omg.CORBA.ORB  orb  =  org.  omg.CORBA.  ORB.  ini  t  (parent  ,  null); 


//  Get  a  reference  to  the  Naming  service 
org . omg . CORBA. Object  names erviceObj  = 

orb . resolve_init ial_ref erences  ( "NameService " ) ; 

if  (nameServiceObj  ==  null) 

{ 

System. out  .print In  ( "nameServiceObj  =  null”)  ; 
return; 

} 


org .  omg .  CosNamihg .  NamingContext  nameSeirv'ice  = 

org . omg , CosNaming . NamingCont extHelper . narrow 

(nameServiceObj) ; 


if  (nameService  ==  null) 

{ 

System.out. print In ("nameService  =  null”) ; 
return ; 

} 


//  bind  the  NavSec  object  in  the  Naming  service 
org .  omg .  CosNaming .  NameComponent  [ ]  mydispensername  = 

{new  org . omg . CosNaming . NameComponent  ( "NavSecDispenser"  ,  ”  ”)  }  ; 
myDispenser  = 

Navy . NavSecDispenserHelper . narrow 

(nameService . resolve (mydispensername) ) ; 
System.out .  print  In  ("Bind  successful!")  ; 


myNavSec=  myDispenser .  reserveNavSecOb j  ect  ( )  ; 
System.out .println( "Reserved  NavSec  Object"); 


} 


} 

catch  (Exception  e) 
e . printStackTrace ( ) 

} 


{ 


*  This  method  is  used  to  submit  a  change  of  address  query  to  the 

*  the  database 

* 

*  @param  Navy.adressStruct  myAddress Struct 

*  ©return  the  struct  containing  the  address  info 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  boolean  submitAddressChange 

(Navy.adressStruct  myAddressStruct) { 
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boolean  result; 
try{ 

result  =  myNavSec.addAdress(myAddressStruct); 
System.out.println( "Query  run  successfully"); 
return  result; 


} 


} 

catch (Exception  e) { 

System.out.println( "Error  in  processing  query"); 
return  false; 

} 


/** 

*  This  method  is  used  to  add  a  family  member  to  the  database 

* 

*  ©param  Navy .  familyStruct  myFamilyStruct 

*  ©return  the  struct  containing  the  family  member  info 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

public  synchronized  boolean  addFamily 

(Navy. familyStruct  myFamilyStruct) { 

boolean  result; 
try{ 

result  =  myNavSec.addFamily(myFamilyStruct); 

System. out .println( "Query  run  successfully"); 
return  result; 


} 


} 

catch (Exception  e) { 

System. out. print In ("Error  in  processing  query”); 
return  false; 

} 


/** 

*  This  method  is  used  to  add  a  spouse  to  the  database 

* 

*  ©param  Navy. spouseStruct  mySpouseStruct 

*  ©return  the  struct  containing  spouse  info 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  boolean  addSpouse 

(Navy. spouseStruct  mySpouseStruct) { 

boolean  result; 
try{ 

result  =  myNavSec . addSpouse (mySpouseStruct) ; 

System. out .print In ( "Query  run  successfully”); 
return  result; 
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} 

catch (Exception  e) { 

System. out .println{ "Error  in  processing  query"); 
return  false; 

} 


j'k'k 

*  This  method  is  used  to  add  PRT  info  to  the  database 

* 

*  ©pararn  Navy. prt Struct  myPrt Struct 

*  ©return  the  struct  containing  PRT  info 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  boolean  addPrt (Navy.prtStruct  myPrtStruct) { 
boolean  result; 
try{ 

result  =  myNavSec.addPrt(rayPrtStruct); 

System.out.println ("Query  run  successfully")  ; 
return  result; 

} 

catch (Exception  e) { 

System. out .print In ("Error  in  processing  query"); 

‘  return  false; 

} 

} 


/** 

*  This  method  is  used  to  add  a  members  leave  data  to  the  database 

•k 

*  ©param  Navy . leave Struct  myLeaveStruct 

*  ©return  the  struct  containing  a  members  leave  info 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

public  synchronized  boolean  addLeave 

(Navy. leaveStruct  myLeaveStruct) { 

boolean  result; 
try{ 

result  =  myNavSec.addLeave(myLeaveStruct); 

System. out .println ("Query  run  successfully"); 
return  result; 


} 

catch (Exception  e) { 

System. out .println ("Error  in  processing  query"! 
return  false; 

} 
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*  This  method  is  used  to  add  a  members  NEC  info  to  the  database 

* 

*  @param  Navy .necS true t  myNecStruct 

*  ©return  the  struct  containing  the  members  NEC  info 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

public  synchronized  boolean  addNec (Navy .necS true t  myNecStruct) { 
boolean  result; 
try{ 

result  =  myNavSec. addNec (myNecStruct) ; 

System. out . print In ("Query  run  successfully”); 
return  result; 


} 


} 

catch (Exception  e) { 

System. out .println( "Error  in  processing  query”); 
return  false; 

} 


/** 

*  This  method  is  used  to  add  new  minor  property  to  the  database 

* 

*  ©param  Navy  .propertyStruct  myPropertyStruct 

*  ©return  the  struct  containing  the  minor  property  info 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

public  synchronized  boolean  addProperty 

(Navy. propertyStruct  myPropertyStruct) { 

boolean  result; 
try{ 

result  =  myNavSec.addProperty(myPropertyStruct); 

System. out .print In ("Query  run  successfully”); 
return  result; 

} 

catch (Exception  e) { 

System. out .println ( "Error  in  processing  query”); 
return  false; 

} 

} 


/** 

*  This  method  is  used  to  add  a  department  to  the  database 

* 

*  ©param  Navy,  department  Struct  myDepartmentStruct 

*  ©return  the  stmet  containing  department  info 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 
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public  synchronized  boolean  addDepartment 

(Navy. departments truct  myDepartmentStruct) { 

boolean  result; 
try{ 

result  =  myNavSec.addDepartment(myDepartmentStruct); 
System.out.  print  In  ("Query  run  successfully"); 
return  result; 


} 

catch (Exception  e) { 

System. out. print In ("Error  in  processing  query"); 
return  false; 

} 

} 


*  This  method  is  used  to  add  a  division  to  the  database 

* 

*  ®param  Navy,  divisions  truct  myDivisionS  truct 

*  ©return  the  struct  containing  division  info 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  boolean  addDivision 

(Navy . divisionStruct  myDivisionS truct) { 

boolean  result; 
try{ 

result  =  myNavSec.addDivision(myDivisionStruct); 

System. out .println( "Query  run  successfully"); 
return  result; 


} 


} 

catch (Exception  e) { 

System. out .println( "Error  in  processing  query"); 
return  false; 

} 


j  ’k'k 

*  This  method  is  used  to  add  maintenance  info  to  the  database 

* 

*  ©param  Navy .maintenances truct  myMaintenanceS truct 

*  ©return  the  struct  containing  maintenance  completed  info 

*  ©exception  Default  Exception  to  catch  all  errors. 

V 

public  synchronized  boolean  addMaintLog 

(Navy .maintenanceStruct  myMaintenanceS truct)  { 

boolean  result ; 
try{ 

result  =  myNavSec.addMaintLog(myMaintenanceStruct); 
System.out.  print  In  ("Query  run  successfully"); 
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return  result; 


} 

catch (Exception  e) { 

. System. out .println( "Error  in  processing  query"); 
return  false; 

} 

} 

/** 

*  This  method  is  used  to  add  a  new  sailor  to  the  database 

* 

*  ©param  Navy.  sailorStruct  mySailorStruct 

*  ©return  the  struct  containing  the  sailors  info 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  boolean  addSailor 

(Navy . sailorStruct  mySailorStruct) { 

boolean  result ; 
try{ 

result  =  myNavSec.addSailor(mySailorStruct); 

System. out .println ( "Query  run  successfully"); 
return  result; 

} 

catch (Exception  e) { 

System. out .println ( "Error  in  processing  query" )  ; 
return  false; 

}  . 

} 


/** 

*  This  method  is  used  to  add  sea  mission  info  to  the  database 

* 

*  ©param  Navy. seamissionStruct  mySeamissionStruct 

*  ©return  the  struct  containing  the  mission  info 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  boolean  addSeaMission 

(Navy . seamissionStruct  mySeamissionStruct) { 

boolean  result; 
try{ 

result  =  myNavSec.addSeaMission(mySeamissionStruct); 
System,  out  .println  ("Query  run  successfully"); 
return  result ; 


} 

catch (Exception  e) { 

System. out .println ("Error  in  processing  query"); 
return  false; 

} 
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} 


*  This  method  is  used  to  add  air  mission  info  to  the  database 

* 

*  ©param  Navy .  airmissionStruct  myAirmissionStruct 

*  ©return  the  struct  containing  the  mission  info 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  boolean  addAirMission 

(Navy .airmissionStruct  myAirmissionStruct)  { 

boolean  result; 
try{ 

result  =  myNavSec.  addAirMission  (myAirmissionStruct)  ; 
System. out. print In ("Query  run  successfully"); 
return  result; 


} 


} 

catch (Exception  e) { 

System. out .println ( "Error  in  processing  query”); 
return  false; 

} 


/** 

*  This  method  is  used  to  change  department  info  in  the  database 

* 

*  ©param  Navy,  department  Struct  myDepartment  Struct 

*  ©return  the  struct  containing  the  new  department  info 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  boolean  changeDepartment 

(Navy,  department  Struct  myDepartmentStruct)  { 

boolean  result; 
try{ 

result  =  myNavSec.changeDeptlnfo(myDepartmentStruct); 
System.out .println ("Query  run  successfully"); 
return  result; 


} 


} 

catch (Exception  e) { 

System.out .println ("Error  in  processing  query")  ; 
return  false; 

} 
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/** 

*  This  method  is  used  to  provide  authorization  for  access  to 

*  the  database 

* 

*  ©param  String  userName 

*  ©param  String  password 

*  ©return  boolean 

*  ©exception  none 
*/ 

piiblic  synchronized  boolean  getAuthorization (String  userName, 

String  password) { 

boolean  result; 
try{ 

result  =  myNavSec.  getAuthorization  (userName,  password); 
System. out .println( "Query  run  successfully"); 
return  result; 

} 

catch (Exception  e) { 

System.out.println( "Error  in  processing  query"); 
return  false; 

} 

} 

/** 

*  This  method  is  used  to  change  division  info  in  the  database 

* 

*  ©param  Navy. divisionSt rue t  myDivisionStruct 

*  ©return  the  struct  containing  new  division  info 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  boolean  changeDivision 

(Navy.divisionStruct  myDivisionStruct) { 

boolean  result; 
try{ 

result  =  myNavSec.changeDivisionlnfo(myDivisionStruct); 
System. out . print In ("Query  run  successfully")  ; 
return  result; 

} 

catch (Exception  e) { 

System. out .println( "Error  in  processing  query"); 
return  false; 

} 

} 
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/** 

*  This  method  is  used  to  retrieve  family  member  info  from  the 

*  database 

* 

*  ©param  String  sailorSsn,  String  lastName 

*  ©return  information  about  a  specific  sailors  family  members 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  Navy .  f  ami lydescStruct  []  getFamilyMembers 

.  (String  sailorSsn, String  lastName) { 
Navy . familydescStruct []  result  =  null; 
try{ 

result  =  myNavSec. getFamilyMembers  (sailorSsn,  lastName)  ; 
System. out .println ( "Query  run  successfully"); 
return  result; 


} 


} 

catch (Exception  e) { 

System. out. print In ("Error  in  processing  query"); 
return  null; 

} 


/★* 

*  This  method  is  used  to  retrieve  spouse  info  from  the 

*  database  from  a  specific  sailors  data 

* 

*  ©param  .String  sailorSsn,  String  lastName 

*  ©return  information  about  a  specific  sailors  spouse 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  Navy. spousedescStruct  getSpouse 

(String  sailorSsn, String  lastName) { 
Navy. spousedescStruct  result  =  null; 
try{ 

result  =  myNavSec.getSpouse(sailorSsn,lastName); 
System.out.println( "Query  run  successfully"); 
return  result; 


} 


} 

catch (Exception  e) { 

System. out .print In ( "Error  in  processing  query"); 
return  null; 

} 
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/•kit 

*  This  method  is  used  to  retrieve  leave  info  from  the 

*  database  regarding  a  specific  sailor 

* 

*  @param  String  sailorSsn,  String  lastName 

*  ©return  information  about  a  specific  sailors  leave  data 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

public  synchronized  Navy. leavedescStruct []  getLeaves 

(String  sailorSsn, String  lastName) { 
Navy . leavedescStruct  []  result  =  null; 
try{ 

result  =  myNavSec.getLeaveData(sailorSsn,lastName); 
System,  out  .print  In  { "Query  run  successfully"); 
return  result; 


} 


} 

catch (Exception  e) { 

System.out.println( "Error  in  processing  query"); 
return  null; 

} 


fkk 

*  This  method  is  used  to  retrieve  PRT  info  from  the 

*  database  regarding  a  specific  sailor 

* 

*  ©param  String  sailorSsn,  String  lastName 

*  ©return  information  about  a  specific  sailors  PRT  data 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  Navy.prtdescStruct []  getPrtResults 

(String  sailorSsn, String  lastName) { 
Navy .prtdescStruct []  result  =  null; 
try{ 

result  myNavSec.getPrtResults(sailorSsn,lastName); 
System,  out .  print  In  ("Query  run  successfully"); 
return  result; 


} 

catch (Exception  e) { 

System. out .print In ( "Error  in  processing  query"); 
return  null; 

} 
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J’k* 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  a  specific  sailors  deployment  time 

* 

*  ©param  String  sailorSsn,  String  lastName,  String  startDate, 

*  String  stopDate 

*  ©return  information  about  a  specific  sailors  deployment  time 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  Navy . deployment Struct []  getDaysDeployed 

(String  sailorSsn, String  lastName, 

String  startDate, String  stopDate) { 

Navy. deployments truct []  result  =  null; 
try{ 

result  =  myNavSec .getDaysDeployed (sailorSsn, lastName, 

StartDate, StopDate) ; 

System.out. print In ("Query  run  successfully  returning"+  result) 
return  result; 

} 

catch  (Exception  e)  { 

System. out . print In ("Error  in  processing  query") ; 
e. prints tackTrace 0 ; 
return  null; 

} 

} 

/** 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  minor  property  listings 

* 

*  ©param  String  commandid 

*  ©return  information  about  a  specific  commands  property  listing 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  Navy .propertydescStruct []  getPropertyList 

(String  commandid) { 

Navy .propertydescStruct []  result  =  null; 
try{ 

result  =  myNavSec.getPropertyList(commandld); 

System.out.println ("Query  run  successfully  returning "+  result) 
return  result; 


} 

catch  (Exception  e)  { 

System. out .println ( "Error  in  processing  query"); 
e.printStackTrace 0 ; 
return  null; 
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/-kic 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  specific  mission  information 

* 

*  ©param  String  platform.  String  typeOf Miss ion,  String 

*  missioxiArea,  String  startDate,  String  stopDate 

*  ©return  information  about  a  specific  mission 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

public  synchronized  Navy .  seamissiondescStruct  []  getSeaMissions 

(String  platform.  String  typeOfMission, 
String  mi ssionArea, String  startDate, 
String  stopDate) { 

Navy . seamissiondescStruct []  result  =  null; 
try{ 

result  =  myNavSec. getSeaMissions 

(platform, typeOfMission , missionArea , 
startDate,stopDate); 

System. out ,println( "Query  run  successfully  returning"+  result); 
return  result; 


catch (Exception  e) { 

System,  out .  print  In  ("Error  in  processing  query"); 
e. prints tackTrace 0 ; 

•return  null; 

} 

} 

/** 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  specific  mission  information 

* 

*  ©param  String  platform.  String  startDate,  String  stopDate 

*  ©return  information  about  a  specific  mission 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  Navy .  seamissiondescStruct  [] 

getSeaMissionsByPlatform (String  platform, String  startDate, 

String  stopDate) { 

Navy. seamissiondescStruct []  result  =  null; 
try{ 

result  =  myNavSec. getSeaMissionsByPlatform (platform, 

StartDate, StopDate) ; 

System. out .println( "Query  run  successfully  returning"+  result); 
return  result; 


} 

catch (Exception  e) { 

System,  out  .print  In  ("Error  in  processing  query")  ; 
e . printStackTrace ( )  ; 
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return  null; 


} 

} 

/** 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  a  specific  sea  mission  by  area 

* 

*  ©param  String  missionArea,  String  startDate,  String  stopDate 

*  ©return  information  about  a  specific  sea  mission 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

public  synchronized  Navy .  seamissiondescStruct  []  getSeaMissionsByArea 

(String  missionArea, String  startDate, 
String  stopDate) { 

Navy. seamissiondescStruct []  result  =  null; 
try{ 

result  =  myNavSec. getSeaMissionsByArea  (missionArea, 

startDate, StopDate) ; 

System.out.println ("Query  run  successfully  returning"+  result); 
return  result; 

} 

catch (Exception  e) { 

System. out .println( "Error  in  processing  query")  ; 
e .printStackTrace 0 ; 
return  null; 

} 

} 

/** 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  a  specific  sea  mission  by  type 

* 

*  ©param  String  typeOfMission,  String  startDate,  String  stopDate 

*  ©return  information  about  a  specific  sea  mission 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  Navy .  seamissiondescStruct  []  getSeaMissionsByType 

(String  typeOfMission,  String  startDate, 
String  stopDate) { 

Navy. seamissiondescStruct []  result  =  null; 
try{ 

result  =  myNavSec. getSeaMissionsByType  (typeOfMission, 

StartDate, StopDate) ; 

System.out. print In ("Query  run  successfully  returning"+  result); 
return  result; 

} 

catch (Exception  e) { 
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System. out . print In ("Error  in  processing  query"); 
e. prints tackTrace 0 ; 
return  null; 

} 

} 

j'k'k 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  a  specific  sea  mission  exercise 

* 

*  ©param  String  exerciseName,  String  startDate,  String  stopDate 

*  ©return  information  about  a  specific  sea  exercise 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  Navy. seamissiondescStruct  [] 

getSeaMissionsByExercise 
(String  exerciseName, String  startDate, 
String  stopDate) { 

Navy . seamissiondescStruct []  result  =  null; 
try{ 

result  =  myNavSec .getSeaMissionsByExercise  (exerciseName, 

StartDate, StopDate) ; 

System. out . print In ("Query  run  successfully  returning”+  result); 
return  result; 

}  .  •  . 
catch (Exception  e) { 

System.out.println( "Error  in  processing  query"); 
e .prints tackTrace  0 ; 
return  null; 

} 

} 

/** 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  a  specific  sea  mission  by  platform  name 

* 

*  ©param  String  platfonn.  String  startDate,  String  stopDate 

*  ©return  infdrmation  about  a  specific  sea  mission 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

ptLblic  synchronized  Navy .  seamissiondescStruct  [] 

getSeaMissionsByPlatformName (String  platform, String  startDate, 

String  stopDate) { 

Navy . seamissiondescStruct []  result  =  null; 
try{ 

result  =  myNavSec.  getSeaMissionsByPlatformName 
(platform, StartDate, StopDate) ; 

System. out .println( "Query  run  successfully  "); 
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return  result; 


} 

catch (Exception  e) { 

System.out. print In ("Error  in  processing  query"); 
e.printStackTrace 0 ; 
return  null; 

} 

} 

y  ★  ★ 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  a  specific  air  mission 

* 

*  ©param  String  Squadron,  String  platform,  String  typeMission, 

*  String  missionArea,  String  startDate,  String  stopDate 

*  ©return  information  about  a  specific  air  mission 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  Navy.  airmissiondescStruct  [] 

get AirMissions (String  squadron, String  platform, 

String  typeMission, 

String  missionArea,  String  startDate, 

String  stopDate) { 

Navy. airmissiondescStruct []  result  =  null; 
try{ 

result  =  myNavSec.getAirMissions 

(squadron, platform, typeMission, missionArea, 
StartDate, StopDate) ; 

System.out.println( "Query  run  successfully  ")  ; 
return  result; 

} 

catch (Exception  e) { 

System.out . print In ("Error  in  processing  query"); 
e . printStackTrace ( )  ; 
return  null; 

} 

} 

/** 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  a  specific  air  mission  by  platform  number 

* 

*  ©param  String  platformNo,  String  startDate,  String  stopDate 

*  ©return  information  about  a  specific  air  mission 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  Navy . airmissiondescStruct [] 
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get AirMi s  s ionByPl a t  f ormNo 

(String  platformNo, String  startDate,  String  stopDate) { 
Navy.airmissiondescStruct []  result  =  null; 
try{ 

result  =  myNavSec.getAirMisByPlatformNo 

(plat f ormNo, startDate, StopDate) ; 

System,  out  .print In  ( "Query  run  successfully  " )  ; 
return  result; 


} 

catch (Exception  e) { 

System. out .println ( "Error  in  processing  query"); 
e . prints tackTrace ( ) ; 
return  null; 

} 

} 

/** 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  a  specific  air  mission  by  area 

* 

*  ©param  String  missionArea,  String  startDate,  String  stopDate 

*  ©return  information  about  a  specific  air  mission 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

piiblic  synchronized  Navy.airmissiondescStruct  [] 

getAirMissionByArea  (String  missionArea,  String  startDate, 

String  stopDate) { 

Navy.airmissiondescStruct []  result  =  null; 
try{ 

result  =  myNavSec.getAirMisByArea 

(missionArea, startDate, stopDate) ; 

System,  out  .println  ( "Query  run  successfully  ")  ; 
return  result; 


} 


} 

catch (Exception  e) { 

System . out . println ( "Error  in  processing  query" ) ; 
e . pr intStackTrace ( ) ; 
return  null; 

} 
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f-k-k 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  a  specific  air  mission  by  type 

* 


*  ©param  String  typeMission,  String  startDate,  String  stopDate 

*  ©return  information  about  a  specific  air  mission 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  Navy.airmissiondescStruct [] 

getAirMissionByType (String  typeMission,  String  startDate, 

String  stopDate) { 

Navy .airmissiondescStruct []  result  =  null; 
try{ 

result  =  myNavSec.getAirMisByType 

(typeMission, startDate, stopDate) / 


System.out.println( "Query  run  successfully  "); 
return  result; 


} 


} 

catch (Exception  e) { 

System. out . print In ("Error  in  processing  query"); 
e  .printStackTrace 0 ; 
return  null; 

} 


/** 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  a  specific  air  mission  by  exercise 

* 


*  ©param  String  exerciseName ,  String  startDate,  String  stopDate 

*  ©return  information  about  a  specific  air  mission 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

piiblic  synchronized  Navy.airmissiondescStruct  [] 

getAirMissionByExercise (String  exerciseName, String  startDate, 

String  stopDate) { 

Navy.airmissiondescStruct []  result  =  null; 
try{ 

result  =  myNavSec . getAirMisByExercise 

(exerciseName, StartDate, StopDate) ; 


System. out .print In ( "Query  run  successfully  ") ; 
return  result; 


} 

catch (Exception  e) { 

System. out .println ( "Error  in  processing  query") ; 
e.printStackTrace 0 ; 
return  null; 
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J'k'k 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  a  specific  air  mission  by  squadron 

* 

*  ©param  String  squadron.  String  startDate,  String  stopDate 

*  ©return  information  about  a  specific  air  mission 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  Navy . airmissiondescStruct [] 

getAirMissionBySquadron (String  squadron, String  startDate, 

String  stopDate) { 

Navy. airmissiondescStruct []  result  =  null; 
try{ 

result  =  myNavSec.getAirMisBySquadron 

(squadron, StartDate, StopDate) ; 

System.out.println( "Query  run  successfully  ”)  ; 
return  result ; 


} 


} 

catch (Exception  e) { 

System.out. print In ("Error  in  processing  query"); 
e .printStackTrace 0 ; 
return  null; 

} 


/** 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  the  demographics  of  a  specific  command  by  gender 

* 

*  ©param  String  commandid,  String  sex 

*  ©return  information  about  a  specific  commands  demographics 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

public  synchronized  Navy . demographics truct [] 

getComDemByGender (String  commandid.  String  sex)  { 

Navy . demographic Struct []  result  =  null; 
try{ 

result  =  myNavSec.getComDemByGender(commandId,sex); 

System.out.println ("Query  run  successfully  ")  ; 
return  result; 


} 

catch (Exception  e) { 

System.out.println ("Error  in  processing  query"); 
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e.printStackTrace 0 ; 
return  null; 


} 


} 


/** 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  a  specific  commands  demographics  by  nec 

* 


*  ©param  String  commandid.  String  necl,  String  nec2, 

*  String  nec3 

*  ©return  information  about  a  specific  commands  demographics 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

piiblic  synchronized  Navy .  demographicStruct  [] 

getComDemByNec (String  commandid,  String  necl.  String  nec2, 
String  nec3) { 

Navy. demographicStruct []  result  =  null; 
try{ 

result  =  myNavSec.getComDemByNec ( commandid, necl, nec2,nec3); 


System.out. print In ("Query  run  successfully  ")  ; 
return  result; 


} 


} 

catch  (Exception  e) { 

System. out .print In ( "Error  in  processing  query") ; 
e . printStackTrace ( ) ; 
return  null; 

} 


*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  a  specific  commands  demographics  by  rank 

* 

*  ©param  String  sailorSsn,  String  paygrade 

*  ©return  information  about  a  specific  commands  demographics 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  Navy . demographicStruct [] 

getComDemByRank (String  sailorSsn,  String  paygrade) { 

Navy. demographicStruct []  result  =  null; 
try{ 

result  =  myNavSec. getComDemByRank (sailorSsn, paygrade) ; 

System.out.println( "Query  run  successfully  ") ; 
return  result; 
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} 


catch (Exception  e) { 

System. out .println ( "Error  in  processing  query"); 
e.printStackTrace 0 ; 
return  null; 


} 


/** 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  a  specific  commands  emergency  list 

* 

*  ©param  String  commandid 

*  ©return  ,  information  about  a  specific  commands  roster 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

piiblic  synchronized  Navy .  emergencyStruct  [] 

getEmergencyList (String  commandid) { 
Navy. emergencyStruct [J  result  =  null; 
try{ 

result  =  myNavSec  .getEmergencyList  (commandid)  ; 

System,  out  .println  ("Query  run  successfully  "); 
return  result; 

} 

catch (Exception  e) { 

System. out .println ("Error  in  processing  query"); 
e.printStackTrace 0 ; 
return  null; 

} 

} 

/** 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  a  specific  commands  maintenance  data 

* 

*  ©param  String  commandid,  String  departmentid.  String 

*  startDate,  String  stopDate 

*  ©return  information  about  a  specific  commands  maintenance 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  Navy . commaintenanceStruct [] 

getMaintByCommand (String  commandid , 

String  departmentid. 

String  startDate,  String  stopDate) { 
Navy . commaintenanceStruct []  result  =  null; 
try{ 

result  =  myNavSec.  getMaintByCommand  (commandid,  departmentid, 

StartDate,  stopDate) ; 
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System.out.println ("Query  run  successfully  ") ; 
return  result; 

} 

catch (Exception  e) { 

System. out .print In ( "Error  in  processing  query"); 
e.printStackTrace 0 ; 
return  null; 

} 

} 

/** 

*  This  method  is  used  to  retrieve  info  from  the 

*  database  regarding  a  specific  commands  maintenance  by  item 

* 

*  ©param  String  item 

*  ©return  maint  information  about  a  specific  item  in  a  command 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  synchronized  Navy . itemmaintenanceStruct [] 

getMaintByl tern (String  item) { 

Navy. itemmaintenanceStruct  []  result  =  null; 
try{ 

result  =  myNavSec .getMaintByltem (item)  ; 

System. out .println( "Query  run  successfully  ") ; 
return  result; 

} 

catch (Exception  e) { 

System. out .println( "Error  in  processing  query"); 
e.printStackTrace 0 ; 
return  null; 

} 

} 


/** 

*  This  method  is  used  to  release  the  CORBA  server  object 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

public  void  releaseObject (  ){ 
try{ 

myDispenser.releaseNavSecObject (myNavSec) ; 

} 

catch (Exception  e) { 

} 

} 

) 
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// - - - - 

//  Filename  :  AdminPanel .  java 
//  Authors  :  Murat  Akbay  &  Steve  Lewis 
//  Date  :  10/17/1998 

//  Compiler  :  JDK1,1.6  with  Symantec  JIT  Compiler 
// - 

import  j  ava . awt , *  ; 
import  j  ava . applet . * ; 
import  borland . j  bcl . layout . *  ; 
import  borland . j  bcl . control . *  ; 
import  com . sun . j  ava . swing . * ; 
import  j  ava . awt . event . * ; 

j  'k-k 

*  This  class  is  used  to  create  the  administration  GUI  panel 

* 

*  ©authors  Murat  Akbay  &  Steve  Lewis 
*/ 

public  class  AdminPanel  extends  JPanel{ 

XYLayout  xYLayoutl  =  new  XYLayoutO; 

JTabbedPane  jTabbedPanel  =  new  JTabbedPane  ( )  ; 
ChangeAddressBean  jPanell; 

AddFamilyBean  jPanel2; 

AddSpouseBean  j Panels;  . 

AddPrtBean  jPanel4  ; 

AddLeaveBean  j Panel 5; 

AddSailorBean  j Panels ; 

AddNecBean  jPanel7; 

GetFamilyMemberBean  j Panels  ; 

Get SpouseBean  j  Panel 9 ; 

GetLeaveBean  j  Panel 1 0 ; 

GetPrtBean  jPanelll; 

GetDaysDeployedBean  jPanell2; 

BevelPanel  headerPanel  =  new  BevelPanel () ; 

XYLayout  xYLayout2  -  new  XYLayout  ( )  ; 

JLabel  jLabell  =  new  JLabeK); 
private  Gui  parentApplet ; 


j  kk 

*  This  is  the  constructor  used  to  create  all  of  the  panels  in  the 

*  admin  panel  GUI  interface 

* 

*  ©param  Gui  parent 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

public  AdminPanel (Gui  parent)  { 
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parentApplet  =  parent; 

//create  the  panels 

jPanell  =  new  Change AddressBean (parentApplet) ; 
jPanel2  =  new  AddFamilyBean  (parentApplet)  ; 
jPanelS  =  new  AddSpouseBean (parentApplet)  ; 
jPanel4  =  new  AddPrtBean (parentApplet)  ; 
jPanel5=  new  AddLeaveBean (parentApplet) ; 
jPanel6  =  new  AddSailorBean (parentApplet) ; 
jPanelT  =  new  AddNecBean (parentApplet) ; 
jPanelS  =  new  GetFamilyMemberBean (parentApplet ) ; 
jPanelS  =  new  GetSpouseBean (parentApplet) ; 
jPanellO  =  new  GetLeaveBean (parentApplet) ; 
jPanelll  =  new  GetPrtBean (parentApplet) ; 
jPanell2  =  new  GetDaysDeployedBean (parentApplet) ; 
//initialize  the  panel 
try  { 

jblnit  0  ; 

} 

catch  (Exception  ex)  { 
ex. print S tackTrace 0 ; 

} 

) 


*  This  method  is  used  to  initialize  the  admin  panels 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

private  void  jblnit ()  throws  Exception  { 
headerPanel . setLayout (xYLayout2 ) ; 

jLabell.setText  ("NAVY  SECURITY  GROUP  ”  +  "EIS  ADMINISTRATION"); 

this . setLayout (xYLayoutl) ; 

xYLayoutl . setHeight (576) ; 

this. setBackground (Color. lightGray) ; 

xYLayoutl. setWidth( 776) ; 

//add  the  panels 

this .add (jTabbedPanel,  new  XYConstraints (11 ,  41,  745,  521)); 
this .add (headerPanel,  new  XYConstraints (11,  4,  745,  29)); 
headerPanel. add (jLabell,  new  XYConstraints (91,  3,  568,  23)); 
JScrollPane  scrollpane  =  new  JScrollPane ( jPanel6 , 

ScrollPaneConstant s  .  VERTICAL__SCROLLBAR_ALWAYS  , 
ScrollPaneConstants .HORIZONTAL_SCROLLBAR_NEVER) ; 
scrollpane. setPreferredSize (new  Dimension (656, 460) ) ; 
jTabbedPanel.addTabC Change  Sailor  Address",  jPanell) ; 
j TabbedPanel . addTab ( "Add  Family  Member  ” ,  j  Panel2 ) ; 
jTabbedPanel.addTab( "Add  Spouse  ”  ,  jPanel3); 
j TabbedPanel. addTab ("Add  Prt  Data",  jPanel4); 
j TabbedPanel. addTab ("Add  Leave  Data",  j Panels ) ; 
j TabbedPanel . addTab ( "Add  Sailor  " , scrollpane) ; 


240 


jTabbedPanel . addTab ( "Update  Nec” , j  Panel? ) ; 

jTabbedPanel.addTab(”Get  Family  Members" , jPanel 8) ; 
jTabbedPanel. addTab ("Get  Spouse  Of  The  Sailor",jPanel9); 
jTabbedPanel .addTab ( "Get  Leave  Data" , jPanellO) ; 
jTabbedPanel . addTab ( "Get  Prt  Results" , jPanelll) ; 
jTabbedPanel . addTab ( "Get  Days  Deployed" , jPanell2) ; 

} 

} 
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//---- . 

//  Filename 
//  Authors 
//  Date 
//  Compiler 
// - 


CommandPanel . j  ava 

Murat  Akbay  &  Steve  Dewis 

10/17/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


import  j  ava . awt . * ; 
import  java. applet.*; 
import  borland . j  bcl . layout . * ; 
import  borland . j  bcl . control . * ; 
import  com . sun , j  ava . swing . * ; 
import  j  ava . awt . event . * ; 


/** 

*  This  class  is  used  to  create  the  command  GUI  panel 

* 

*  ©authors  Murat  Akbay  &  Steve  Lewis 
*/ 

public  class  CommandPanel  extends  JPanel{ 

XYLayout  xYLayoutl  =  new  XYLayoutO; 

JTabbedPane  jTabbedPanel  =  new  JTabbedPane ( )  / 
AddDepartmentBean  j Panel 1  ; 

AddDivisionBean  jPanel2  ; 

ChangeDepartmentBean  j  Panels  ; 

ChangeDivisionBean  jPanel4  ; 

GetComDemByGenderBean  j  Panel5; 

GetComDemByNecBean  j  Panels ; 

Ge t ComDemByRankBean  j  Panel 7 ; 

GetEmergencyListBean  j  Panels ; 
private  Gui  parentApplet ; 

JLabel  jLabell  =  new  JLabelO; 

XYLayout  xYLayout2  =  new  XYLayout  ( )  ; 

BevelPanel  headerPanel  =  new  BevelPanel ( ) ; 


/★* 

*  This  is  the  constructor  used  to  create  all  of  the  panels  in  the 

*  command  panel  GUI  interface 

•k 

*  ©param  Gui  parent 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  CommandPanel (Gui  parent)  { 
parentApplet  =  parent ; 

jPanell  =  new  AddDepartmentBean (parentApplet) ; 
jPanel2  =  new  AddDivisionBean (parentApplet) ; 
j Panels  =  new  ChangeDepartmentBean (parentApplet) ; 
jPanel4  =  new  ChangeDivisionBean (parentApplet); 
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j Panels  =  new  Get ComDemByGenderBean (parent Applet ) ; 
j  Panels  new  GetComDemByNecBean  (parentApplet)  ; 
j Panel?  =  new  GetComDemByRankBean (parentApplet) ; 
jPanelS  =  new  GetEmergencyListBean (parentApplet) ; 
try  { 

jblnit  0  ; 

} 

catch  (Exception  ex)  { 
ex. prints tackTrace 0  ; 

} 

} 


/** 

*  This  method  is  used  to  initialize  the  command  panels 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors, 

*/ 

private  void  jblnit ()  throws  Exception  { 

this ,  setLayout  (xYLayoutl)  ; 
xYLayout 1 . s e t He ight (576)  ; 

j  Label  1.  setText  ("  NAVY  SECURITY  GROUP  "  +"  EIS  COMMAND"); 
headerPanel .  setLayout  (xYLayout2)  ; 
this .  setBackground  (Color .  lightGray)  ; 
xYLayoutl. setWidth (776)  ; 

this. add (jTabbedPanel,  new  XYConstraints (11,  41,  745,  521)); 
this,  add  (header  Panel,  new  XYConstraints  (11,  4,  745,  29)); 
headerPanel. add (jLabell,  new  XYConstraints  (122 ,  6,  -1,  *1)  )  ; 
j TabbedPanel . addTab ( "Add  Department " ,  j  Panell ) ; 
j  TabbedPanel .  addTab  ( "Add  Division  "  ,  j  Panel2 )  ; 
j  TabbedPanel.  addTab  ("Change  Department  Data"  ,  j  Panels )  ; 
j  TabbedPanel.  addTab  ("Change  Division  Data  "  ,  jPanel4); 
j TabbedPanel .addTab ( "View  Command  Demographics  By  Gender", 

j Panels) ; 

j  TabbedPanel.  addTab  ("View  Command  Demographics  By  Nec"  ,  jPanelS); 
j  TabbedPanel.  addTab  ("View  Command  Demographics  By  Rank"  ,  j  Panel?) 
j  TabbedPanel.  addTab  ("View  Command  Emergency  List"  ,  j  Panels )  ; 


} 


} 
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1 1- . 

//  Filename 
//  Authors 
//  Date 
//  Compiler 
// . . 


OperationsPanel .java 
Murat  Akbay  &  Steve  Lewis 
10/17/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


import  j  ava . awt . * ; 
import  j ava. applet.*; 
import  borland.jbcl. layout.*; 
import  borland. jbcl. control. *; 
import  com . sun . j  ava . swing . * ; 
import  j  ava . awt . event . * ; 


/** 

*  This  class  is  used  to  create  the  Operations  GUI  panel 

★ 

*  ©authors  Murat  Akbay  &  Steve  Lewis 
*/ 

public  class  OperationsPanel  extends  JPanel{ 

XYLayout  xYLayoutl  =  new  XYLayout ( ) ; 

JTabbedPane  jTabbedPanel  =  new  JTabbedPane ( ) ; 

AddSeaMissionBean  jPanell  ; 

GetSeaMissionsBean  j Panel2 ; 
GetSeaMissionsByPlatformBean  jPanel3 ; 
GetSeaMissionsByAreaBean  jPanel4 ; 
GetSe.aMissionsByTypeBean  jPanelB; 
GetSeaMissionsByExerciseBean  jPanel6 ; 
GetSeaMissionsByPlatformNameBean  j  Panel?; 
AddAirMissionBean  j Panel 8  ; 

GetAirMissionsBean  j Panels ; 

GetAirMissionsByPlatf ormBean  j PanellO ; 
GetAirMissionsByAreaBean  jPanelll; 
GetAirMissionsByTypeBean  jPanell2; 
GetAirMissionsByExerciseBean  jPanell3 ; 
GetAirMissionsBySquadronBean  jPanell4 ; 

private  Gui  parentApplet ; 

JLabel  jLabell  =  new  JLabelO; 

XYLayout  xYLayout2  =  new  XYLayout ( ) ; 

BevelPanel  headerPanel  =  new  BevelPanel  ( ) ; 
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/** 

*  This  is  the  constructor  used  to  create  all  of  the  panels  in  the 

*  Operations  panel  GUI  interface 

* 

*  @param  Gui  parent 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  OperationsPanel (Gui  parent)  { 
parentApplet  =  parent; 

jPanell  =  new  AddSeaMissionBean (parentApplet) ; 

.jPanel2  =  new  GetSeaMissionsBean (parentApplet) ; 
jPanelS  =  new  GetSeaMissionsByPlatformBean (parentApplet)  ; 
jPanel4  =  new  GetSeaMissionsByAreaBean (parentApplet) ; 
jPanelS  =  new  GetSeaMissionsByTypeBean (parentApplet) ; 
jPaneie  =  new  GetSeaMissionsByExerciseBean (parentApplet) ; 
jPanel?  =  new  GetSeaMissionsByPlatforrnNameBean (parentApplet)  ; 
jPanelS  =  new  AddAirMissionBean (parentApplet) ; 
jPanelS  =  new  GetAirMissionsBean (parentApplet) ; 
jPanellO  =  new  GetAirMissionsByPlatformBean (parentApplet)  ; 
jPanelll  =  new  GetAirMissionsByAreaBean (parentApplet) ; 
jPanell2  =  new  Get AirMissionsByTypeBean (parentApplet) ; 
jPanellS  =  new  GetAirMissionsByExerciseBean (parentApplet)  ; 
jPanell4  =  new  GetAirMissionsBySquadronBean (parentApplet)  ; 
try  { 

jblnit  0 ; 

} 

catch  (Exception  ex)  { 
ex.printStackTrace 0 ; 

} 

} 


/** 

*  This  method  is  used  to  initialize  the  operations  panels 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

private  void  jblnit  ()  throws  Exception  { 
this .  setLayout  (xYLayoutl)  ; 
xYLayoutl .  setHeight  (576)  ; 

jLabell.setText ("NAVY  SECURITY  GROUP”  +  "  EIS  OPERATIONS  & 

TRAINING")  ; 

headerPanel . setLayout (xYLayout2 )  ; 
this . setBackground (Color . lightGray) ; 
xYLayoutl . setWidth (776) ; 

//add  the  panels 

this. add (jTabbedPanel,  new  XYConstraints (13 ,  37,  745,  521)); 
this .add (headerPanel,  new  XYConstraints (11 ,  4,  745,  29)); 
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headerPanel .add (j Label 1,  new  XYConstraints (90,  1,  -1, 
JScrollPane  scrollpane  =  new  JScrollPane (j Panels , 
ScrollPaneConstants . VERTICAL_SCROLLBAR_ALWAYS  , 
ScrollPaneConstants  .HORIZONTAL__SCROLLBAR_NEVER)  ; 
scrollpane . setPreferredSize (new  Dimension (656 , 460) ) ; 
//Icon  orion  =  new  ImageIcon(”orion.gif"); 
jTabbedPanel . addTab ( ”  Add  Sea  Mission",  jPanell); 
jTabbedPanel.addTabC  View  Sea  Missions",  jPanel2); 
jTabbedPanel.addTab(”  By  Platform",  j Panels ) ; 
j  TabbedPanel . addTab ( ”  By  Area ” ,  j  Panel4 ) ; 
jTabbedPanel . addTab ( "  By  Type" ,  j Panels) ; 
j TabbedPanel. addTab (”  By  Exercise",  jPanel6); 
jTabbedPanel.addTabC  By  Platform  Name”,  jPanel7); 
jTabbedPanel.addTabC  Add  Air  Mission",  scrollpane) 
jTabbedPanel.addTabC  View  Air  Missions",  jPanel9); 
jTabbedPanel .addTab ( "  By  Platform  No",jPanellO); 
j TabbedPanel. addTab ("  By  Mission  Area",jPanelll)/ 
jTabbedPanel.addTabC  By  Type”,jPanell2); 
j TabbedPanel. addTab ("  By  Exercise” , jPanellS) ; 
jTabbedPanel . addTab ( ”  By  Squadron” , j Panell4 ) ; 


// - 

//  Filename 
//  Authors 
//  Date 
//  Compiler 
// - 


MaintenancePanel .java 
Murat  Akbay  &  Steve  Lewis 
10/17/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


import 

import 

import 

import 

import 

import 


j  ava . awt . * ; 
java. applet 

borland. jbcl . layout , * ; 
borland .jbcl. control . * ; 
com. sun. java. swing. *; 
j  ava . awt . event . * ; 


/** 

*  This  class  is  used  to  create  the  Maintenance  GUI  panel 

* 

*  ©authors  Murat  Akbay  a  Steve  Lewis 
*/ 

public  class  MaintenancePanel  extends  JPanel{ 

XYLayout  xYLayoutl  =  new  XYLayout  ( )  ; 

JTabbedPane  jTabbedPanel  =  new  JTabbedPane ( ) ; 
AddMaintBean  jPanell  ; 

GetMaintByCommandBean  jPanel2; 

GetMaintByltemBean  j  Panels ; 
private  Gui  parentApplet ; 

JLabel  jLabell  ==  new  JLabelO; 

XYLayout  xYLayout2  =  new  XYLayout  (); 

BevelPanel  headerPanel  =  new  BevelPanel  {) ; 


/** 

*  This  is  the  constructor  used  to  create  all  of  the  panels  in  the 

*  Maintenance  panel  GUI  interface 

* 

*  ©param  Gui  parent 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  MaintenancePanel (Gui  parent)  { 
parentApplet  =  parent; 

jPanell  =  new  AddMaintBean (parentApplet) ; 
jPanel2  =  new  GetMaintByCommandBean (parentApplet) ; 
j Panels  -  new  GetMaintByltemBean (parentApplet) ; 
try  { 

jblnit  0 ; 

} 

catch  (Exception  ex)  { 
ex . prints tackTrace ( ) ; 

} 
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} 


*  This  method  is  used  to  initialize  the  maintenance  panels 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

private  void  jblnitO  throws  Exception  { 

this . setLayout (xYLayoutl) ; 
xYLayoutl . setHeight (576) ; 
j Label 1 . setText 

("  NAVY  SECURITY  GROUP  "  +  "  EIS  MAINTENANCE”)/ 
headerPanel .  setLayout  (xYLayout2)  ; 
this  .  setBackground  (Color .  lightGray)  ; 
xYLayoutl.setWidth(776) ; 

//add  the  panels 

this  .add  (jTabbedPanel,  new  XYConstraints  (11,  41,  745,  521)); 
this,  add  (headerPanel,  new  XYConstraints  (11,  4,  745,  29)); 
headerPanel  .add  (j  Label  1,  new  XYConstraints  (128 ,  6,  -1,  -1)  )  ; 
JScrollPane  scrollpane  =  new  JScrollPane ( jPanell, 
ScrollPaneConstants .  VERTICAL_SCROLLBAR_ALWAYS  , 
ScrollPaneConstants  .HORIZONTAL_SCROLLBAR__NEVER)  ; 
scrollpane. setPreferredSize  (new  Dimension (656 , 460) )  ; 
jTabbedPanel . addTab ( "Add  Maintenance” ,  scrollpane) ; 
jTabbedPanel . addTab ( "View  Maintenance  By  Command”,  jPanel2) ; 
jTabbedPanel. addTab ("View  Maintenance  By  Item",  j Panels ) ; 

} 

} 
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//-- . - 

//  Filename 
/ /  Authors 
//  Date 
//  Compiler 
// - 


BudgetPanel . j  ava 

Murat  Akbay  &  Steve  Lewis 

10/17/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


import  java.awt.*; 
import  j  ava . applet . * ; 
import  borland. jbcl. layout.*; 
import  bor land . j  bcl . control . *  ; 
import  com. svin. java. swing.*; 
import  j  ava . awt . event . * ; 


/** 

*  This  class  is  used  to  create  the  Budget  GUI  panel 

* 

*  ©authors  Murat  Akbay  &  Steve  Lewis 
*/ 

public  class  BudgetPanel  extends  JPanel{ 

XYLayout  xYLayoutl  =  new  XYLayout  ( )  ; 

JTabbedPane  jTabbedPanel  =  new  JTabbedPane { ) ; 
AddPropertyBean  j  Panel 1  ; 

GetPropertyListBean  jPanel2  ; 
private  Gui  parentApplet ; 

JLabel  jLabell  =  new  JLabelO ; 

XYLayout  XYLayout  2  =  new  XYLayout  ( )  ; 

BevelPanel  headerPanel  =  new  BevelPanel  ()  ; 


/** 

*  This  is  the  constructor  used  to  create  all  of  the  panels  in  the 

*  Budget  panel  GUI  interface 

* 

*  ©param  Gui  parent 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

public  BudgetPanel (Gui  parent)  { 
parentApplet  =  parent; 

jPanell  =  new  AddPropertyBean (parentApplet ) ; 
jPanel2  =  new  GetPropertyListBean (parentApplet) ; 
try  { 

jblnit  0 ; 

} 

catch  (Exception  ex)  { 
ex.printStackTrace 0  ; 

} 

}  ' 
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/** 

*  This  method  is  used  to  initialize  the  budget  panels 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

private  void  jblnitO  throws  Exception  { 
this . setLayout (xYLayoutl) ; 
xYLayoutl . setHeight (576 ) ; 

jLabell.setText ("NAVY  SECURITY  GROUP  "  +  "  EIS  BUDGET  &  SUPPLY"); 
headerPanel . setLayout (xYLayout2) ; 
this . setBackground (Color . lightGray) ; 
xYLayoutl . setWidth (776 )  ; 

this .add (jTabbedPanel,  new  XYConstraints  (11,  41,  745,  521)); 
this. add (headerPanel,  new  XYConstraints  (11,  4,  745,  29)); 
headerPanel. add (jLabell,  new  XYConstraints (105 ,  7,  -1,  -1)); 

jTabbedPanel.addTabC'Add  Property",  jPanell); 
jTabbedPanel.addTabC'View  Properties",  jPanel2)  ; 

} 
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// - 

//  Filename 
//  Authors 
//  Date 
//  Compiler 
// - 


SwitchPanel .java 

Murat  Akbay  &  Steve  Lewis 

10/17/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


import  j  ava . awt . * ; 
import  j  ava . awt . event . * ; 
import  com . sun . j  ava . swing . * ; 
import  borland . j  bcl . layout . * ; 
import  borland . j  bcl . control . * ; 


/** 

*  This  class  is  used  to  create  the  Switch  GUI  panel 

* 

*  ©authors  Murat  Akbay  &  Steve  Lewis 
*/ 

public  class  SwitchPanel  extends  JPanel  implements  ActionListener{ 
XYLayout  xYLayoutl  =  new  XYLayoutO; 

JButton  adminButton  =  new  JButtonO ; 

JButton  commandButton  =  new  JButtonO; 

JButton  operationButton  =  new  JButtonO ; 

JButton  budgetButton  =  new  JButtonO; 

JButton  maintenanceButton  =  new  JButtonO; 

JButton  welcomeButton  =  new  JButtonO ; 
private  Gui  parentApplet ; 

BevelPanel  bevelPanell  =  new  Beve 1 Panel  0 ; 

JLabel  jLabell  ~  new  JLabel () ; 


/** 

*  This  is  the  constructor  used  to  create  all  of  the  panels  in  the 

*  switch  panel  GUI  interface 

* 

*  ©param  Gui  parent 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

pTiblic  SwitchPanel  (Gui  parent)  { 
parentApplet  =  parent; 
try  { 

jblnit  {)  ; 

} 

catch  (Exception  ex)  { 
ex.printStackTrace 0 ; 

} 

} 
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/*★ 

*  This  method  is  used  to  initialize  the  switch  panel 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

void  jblnitO  throws  Exception  { 
xYLayoutl .setHeight (576) ; 
xYLayoutl . setWidth (776) ; 
adminButton.  setText  (  "ADMINISTRATION" )  ; 
adminButton. setBackground (new  Color(192,  192,  224)); 
adminButton. setOpaque (true) ; 
adminButton. addActionListener  (this)  ; 
commandButton .  setText  ( "COMMAND" )  ; 

commandButton. setBackground (new  Color (192,  192,  224)); 
commandButton. setOpaque  (true)  ; 
commandButton .  addActionListener  (this)  ; 
operationButton. setText  ("jButtonl")  ; 
operationButton .  setLabel  ( "OPERATIONS  " )  ; 

operationButton.  setBackground  (new  Color(192,  192,  224)); 
operationButton.  setOpaque  (true)  ; 
operationButton. addActionListener  (this)  ; 
budgetButton. setText ("BUDGET  &  SUPPLY"); 
budgetButton. setBackground (new  Color (192,  192,  224)); 
budgetButton. setOpaque (true) ; 
budgetButton.  addActionListener  (this)  ; 
maintenanceButton . setText ( " j  Buttonl " )  ; 
maintenanceButton.  setLabel  { "MAINTENANCE" )  ; 

maintenanceButton. setBackground (new  Color(192,  192,  224)); 
maintenanceButton.  setOpaque  (true)  ; 
maintenanceButton. addActionListener  (this)  ; 
welcomeButton .  setText  ( "jButtonl " )  ; 
welcomeButton .  setLabel  ( "WELCOME" )  ; 

welcomeButton.  setBackground  (new  Color  (192,  192,  224)); 
welcomeButton . setOpaque (true) ; 

j  Labell.  setText  ("  NAVY  SECURITY  GROUP  "  +  "  EIS"); 
welcomeButton. addActionListener  (this)  ; 
this .  set  Layout  (xYLayoutl)  ; 

this  .add  (budgetButton,  new  XYConstraints  (460 ,  136,  158,  66)); 
this,  add  (maintenanceButton,  new  XYConstraints  (460 ,  226,  158,  66)) 
this . add  (welcomeButton,  new  XYConstraints  (461,  315,  158,  66)); 
this,  add  (adminButton,  new  XYConstraints  (152 ,  137,  158,  66)); 
this  . add  (operationButton,  new  XYConstraints  (154  ,  316,  158,  66)); 
this . add  (commandButton,  new  XYConstraints  (153 ,  227,  158,  66)); 
this. add (bevelPanell,  new  XYConstraints  (72 ,  44,  632,  57)); 
bevelPanel  1.  add  (j  Labell,  new  XYConstraints  (81,  14,  496,  27)),* 

} 
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/** 

*  This  method  is  used  perform  the  actions  required  when  the  user 

*  selects  one  of  the  switches  on  the  panel . 

* 

*  ©param  e  action  performed  by  the  user 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

pxiblic  void  actionPerf ormed (ActionEvent  e)  { 

String  command  =  e . getActionCommand ( ) ; 

if (command . equals ( "ADMINISTRATION" ) ) { 
parentApplet . showAdmin ( )  ; 

} 

else  if  (command. equals  ( "BTJDGET  &  SUPPLY” )  )  { 
parentApplet . showBudget ( )  ; 

} 

else  if  (command. equals  ("COMMAND”) )  { 
parentApplet .  showCommand  ( )  ; 

} 

else  if  (command. equals  ("MAINTENANCE”)  )  { 
parentApplet .  showMaintenance  ( )  ; 

} 

else  if  (command. equals  ("OPERATIONS") )  { 
parentApplet . showOperations ( )  ; 

} 

else  if  (command. equals  ("WELCOME") )  { 

parentApplet .  set  Authorization  (false)  ; 
parentApplet .  welcomePanel .  nameField .  setText  ( ”  " )  ; 
parentApplet. welcomePanel.passwordField.setText  ("  ")  ; 
parentApplet . showWelcome ( )  ; 

} 

} 

} 
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// - 

//  Filenaine 
//  Authors 
//  Date 
//  Compiler 
// - 


WelcomePanel , java 

Murat  Akbay  &  Steve  Lewis 

10/17/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


import  j  ava awt .  *  ; 
import  java.applet 
import  borland.jbcl .layout . 
import  borland. jbcl. control.*; 
import  com . s\m . j ava . swing .* ; 
import  j  ava . awt . event . * ; 


public  class  WelcomePanel  extends  JPanel{ 

XYLayout  xYLayoutl  =  new  XYLayoutO; 

JPanel  entryPanel  =  new  JPanelO; 
private  Gui  parentApplet ; 

XYLayout  xYLayout2  =  new  XYLayout ( ) ; 

BevelPanel  bevelPanell  =  new  BevelPanel ( ) ; 

JLabel  jLabell  =  new  JLabelO; 

JPanel  jPanel2  =  new  JPanelO; 

XYLayout  xYLayoutS  =  new  XYLayoutO; 

JLabel  j  Labe  12  =  new  JLabelO; 

JLabel  jLabel3  =  new  JLabelO; 

JPasswordField  nameField  =  new  JPasswordField  0  ; 
JPasswordField  passwordField  =  new  JPasswordField {) ; 
JButton  submitButton  =  new  JButton () ; 

public -WelcomePanel (Gui  parent)  { 
parentApplet  =  parent; 
try  { 

j  blnit ( ) ; 

} 

catch  (Exception  ex)  { 
ex.printStackTrace 0  ; 

} 

} 


public  boolean  getAuthorization () { 
boolean  retumValue  =  false; 

if  (parentApplet .  corbaBean. getAuthorization  (nameField. getText  ()  .trimO  , 

passwordField . getText ( ) . trim ( ) )  ) { 

returnValue  =  true; 

} 

return  returnValue; 

} 


private  void  jblnitO  throws  Exception  { 
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this . setLayout (xYLayoutl) ; 
xYLayoutl . setHeight (576) ; 

jLabell.setText (”  WELCOME  TO  NAVY  SECURITY  GROUP  "  + 

”  ENTERPRISE  INFORMATION  SYSTEM"); 

jLabel2 . setText ( "LOG  ON  NAME" ) ; 

jLabelS , setText ( "PASSWORD" ) ; 

nameField. setText ( " jPasswordFieldl" ) ; 

passwordField. setText (" jPasswordField2") ; 

submitButton . setText ( " SUBMIT" ) ; 

submitButton . setLabel ( "  ENTER" ) / 

submitButton. setBackground (new  Color (192,  192,  209)); 
si±>mitButton. setOpague  (true)  ; 

submitButton .  addActionListener  (new  java .  awt .  event  .Act ionListener  ( ) 

public  void  act ionPer formed (Act ionEvent  e)  { 
submitButton_actionPerformed(e) ; 

} 

}); 

//logoLabel . setOpaque (true) ; 
j Pane 12 . set Lay out (xYLayoutS ) ; 
entryPanel .  setLayout  (xYLayout2)  ; 
this . setBackground (Color . lightGray) ; 
xYLayoutl. setWidth( 776) ; 

//add  the  panels 

this .add (entryPanel,  new  XYConstraints  (22 ,  69,  722,  439)); 
entryPanel. add (bevelPanell,  new  XYConstraints (11,  272,  694,  63)); 
be vel Panel 1, add (j Label 1,  new  XYConstraints  (27 ,  19,  644,  26)); 
entryPanel. add (jPanel2,  new  XYConstraints (165 ,  352,  348,  73)); 
jPanel2.add( jLabel2,  new  XYConstraints (5 ,  9,  114,  22)); 
jPanel2.add( jLabel3,  new  XYConstraints (5,  40,  114,  22)); 
jPanel2 .add (nameField,  new  XYConstraints  (178 ,  12,  160,  22)); 
jPanel2. add (passwordField,  new  XYConstraints (178 ,  41,  160,  22)); 
this. add (submitButton,  new  XYConstraints (354 ,  528,  -1,  -1)); 
//entryPanel.  add  (logoLabel,  new  XYConstraints  (165 ,  6,  369,  254)); 


} 


void  submitButton__actionPerformed(ActionEvent  e)  { 
if  (getAuthorizationO  ==  true)  { 

this .parentApplet . setAuthorization (true) ; 
this . parentApplet . showSwitch ( ) ; 


// - 

//  Filename  :  AddFamilyBean. java 
//  Authors  ;  Murat  Akbay  &  Steve  Lewis 
//  Date  :  10/17/1998 

/ /  Compiler  ;  JDKl  .1.6  with  Symantec  JIT  Compiler 
// - 


import  j  ava . awt . * ; 
import  borland.jbcl. layout.*; 
import  com . sun . j  ava . swing . * ; 
import  j  ava . awt . event . * ; 
import  j  ava . util . * ; 
import  j  ava . io . * ; 

/** 

*  This  class  is  used  to  create  the  AddFamilyBean  GUI  panel 

* 

*  ©authors  Murat  Akbay  &  Steve  Lewis 
*/ 

public  class  AddFamilyBean  extends  JPanel  implements  ActionListener{ 
XYLayout  xYLayoutl  =  new  XYLayout { ) ; 

JPanel  dataPanel  =  new  JPanel (); 

JPanel  labelPanel  =  new  JPanel (); 

JLabel  ssnLabel  =  new  JLabelO; 

JPanel  headerPanel  =  new  JPanel (); 

JLabel  addPrtLabel  =:  new  JLabelO; 

GridBagLayout  gridBagLayoutS  =  new  GridBagLayout  ( )  ; 

XYLayout  xYLayout2  =  new  XYLayout ( ) ; 

JPanel  buttonPanel  =  new  JPanel  {); 

JPanel  blankPanel  =  new  JPanel  {); 

JButton  submitButton  =  new  JButtonO; 

JButton  clearButton  =  new  JButtonO; 

XYLayout  xYLayoutS  =  new  XYLayout  ()  ; 

JLabel  nameLabel  =  new  JLabelO; 

JLabel  birthLabel  =  new  JLabelO; 

JLabel  sexLabel  =  new  JLabelO; 

JLabel  sailorSsnLabel  =  new  JLabelO; 

JTextField  jTextFieldl  =  new  JTextFieldO; 

JTextField  ssnField  =  new  JTextFieldO  ; 

JTextField  nameField  =  new  JTextFieldO  ; 

JTextField  birthField  =  new  JTextFieldO ; 

JTextField  sexField  =  new  JTextFieldO ; 

JTextField  sailorSsnField  =  new  JTextFieldO; 

JButton  cancelButton  =  new  JButtonO; 

GridBagLayout  gridBagLayoutl  =  new  GridBagLayout  0  ; 
private  Gui  parentApplet ; 
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/** 

*  This  is  the  constructor  used  to  create  the 

*  AddFamilyBean  panel  GUI  interface 

* 

*  ©param  Gui  parent 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors. 
*/ 

public  AddFamilyBean  (Gui  parent)  { 
parent Applet  =  parent; 
try  { 

jblnit  0 ; 

} 

catch  (Exception  ex)  { 
ex . printStackTrace ( ) ; 

}  . 

} 


*  This  method  is  used  to  initialize  the  AddFamilyBean  panel 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

private  void  jblnit ()  throws  Exception  { 

addPrtLabel . setText ( "  ADD  FAMILY  MEMBER  FORM" ) ; 

submitButton . setText ( " SUBMIT" ) ; 

clearButton. setText ("CLEAR") ; 

nameLabel . setText { "  NAME" ) ; 

nameLabel . setOpaque (true) ; 

birthLabel . setText { "  BIRTH  DATE " ) ; 

birthLabel . setOpaque (true) ; 

sexLabel . setText ( "  SEX" ) ; 

sexLabel . setOpaque (true) ; 

sailorSsnLabel . setText ( "  SAILOR  SSN" ) ; 

sailorSsnLabel . setOpaque (true) ; 

j  TextFieldl . setText ( "  " )  ; 

cancelButton . setText ( "CANCEL" ) ; 

ssnField . setText ( "  " ) ; 

nameField . setText ( "  " ) ; 

birthField . setText ( "  " ) ; 

sexField . setText ( "  " ) ; 

sailorSsnField. setText ( "  ") ; 

buttonPanel .  setLayout  (gridBagLayoutl)  ; 

headerPanel .  setLayout  (gridBagLayoutS)  ; 

xYLayoutl . setHeight (460) ; 

ssnLabel . setText ( "  SSN" ) ; 

ssnLabel . setOpaque (true) ; 

labelPanel .  setLayout  (xYLayoutS)  ; 

dataPanel . setLayout (xYLayout2) ; 
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xYLayoutl .  setWidth  (636)  ; 
this . setLayout (xYLayoutl) ; 

this .add (headerPanel,  new  XYConstraints (34 ,  9,  575,  40)); 
headerPanel . add (addPrtLabel ,  new  GridBagConstraints2 

(0,  0,  1,  1,  0.0,  0.0, 
GridBagConstraints .WEST, 
GridBagConstraints .NONE, 
new  Insets 

(7,  153,  6,  136)  ,  98,  12) )  ; 

this. add (buttonPanel,  new  XYConstraints (34 ,  398,  575,  50)); 
buttonPanel . add 

(blankPanel,  new  GridBagConstraints2 (3 ,  0,  1,  1,  1.0,  1.0, 

GridBagConstraints . CENTER , 
GridBagConstraints .BOTH, 
new  Insets 

(7,  18,  8,  46)  ,  253,  25) )  ; 

buttonPanel.add (submitButton,  new  GridBagConstraints2 

(0,  0,  1,  1,  0.0,  0.0, 
GridBagConstraints . CENTER, 
GridBagConstraints .NONE, 
new  Insets 

(15,  8,  12,  0)  ,0,0))  ; 

buttonPanel .add (clearBut ton,  new  GridBagConstraints2 

(1,  0,  1,  1,  0.0,  0.0, 
GridBagConstraints . CENTER, 
GridBagConstraints. NONE , 
new  Insets 

(15,  16,  12,  0)  ,  0,  0.)  )  ; 

buttonPanel .add (cancelButton,  new  GridBagConstraints2 

(2,  0,  1,  1,  0.0,  0.0, 
GridBagConstraints . CENTER, 
GridBagConstraints . NONE , 
new  Insets 

(15,  15,  12,  0),  0,  0)); 

this . add (dataPanel,  new  XYConstraints (34 ,  55,  575,  337)); 

dataPanel.adddabelPanel,  new  XYConstraints  (8,  12,  138,  316)); 
labelPanel.add(ssnLabel,  new  XYConstraints (0,  0,  130,  24)); 
labelPanel.add(nameLabel,  new  XYConstraints (0,  32,  130,  24)); 
labelPanel.add(birthLabel,  new  XYConstraints (0 ,  64,  130,  24)); 

labelPanel.add(sexLabel,  new  XYConstraints (0,  95,  130,  24)); 
labelPanel .add (sailors snLabel,  new  XYConstraints (0 ,  127,  130,  24)) 
labelPanel.add( jTextFieldl,  new  XYConstraints (160 ,  6,  174,  25)); 
dataPanel. add (ssnField,  new  XYConstraints (179,  9,  163,  27)); 
dataPanel. add (nameField,  new  XYConstraints (179,  41,  163,  27)); 
dataPanel. add (birthField,  new  XYConstraints (179 ,  73,  163,  27)); 
dataPanel. add (sexField,  new  XYConstraints (179,  105,  163,  27)); 
dataPanel. add (sailorSsnField,  new  XYConstraints (179, 137, 163 , 27) )  ; 
submitButton. addActionListener (this) ; 
clearButton.addActionListener (this) ; 
cancelButton . addActionListener (this ) ; 

} 
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/** 

*  This  method  is  used  perform  the  actions  required  based  on  what  the 

*  user  enters  for  the  database  modification. 

* 

*  ©param  e  action  performed  by  the  user 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

public  void  actionPerformed (Act ionE vent  e)  { 

String  command  =  e .getActionCommand () ; 

if (command. equals ("SUBMIT") ) { 

Navy . familyStruct  myFamilyStruct  =  new  Navy. familyStruct  ()  ; 
myFamilyStruct . ssn  =  ssnField.getText () .trim() ; 
myFamilyStruct .  name  =  nameField .  ge tText  ( )  .  trim  (); 
myFamilyStruct .  sdate  =  birthField.getText  ()  .  trimO  ; 
myFamilyStruct .  sex  =  sexField.getText  ()  .trimO  ; 
myFamilyStruct . sailorSsn  =  sailorSsnField. getText  ( )  . trim ( )  ; 
parentApplet .  corbaBean . addFamily (myFamilyStruct)  ; 

} 

else  if (command. equals ("CLEAR") ) { 
ssnField. setText ( " " ) ; 
nameField . setText ( " " )  ; 
birthField. setText ( " " )  ; 
sexField. setText ( " " )  ; 
sailorSsnField . setText ( " " ) ; 

} 

else  if  (command. equals  ("CANCEL")  )  { 
parentApplet . showSwitch ( )  ; 

} 


} 


} 
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// . 

//  Filename 
//  Authors 
//  Date 
//  Compiler 
// - 


ChangeAddressBean .java 
Murat  Akbay  &  Steve  Lewis 
10/17/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


import  j  ava . awt . * ; 
import  borland.jbcl. layout 
import  com . sun . j  ava . swing . * ; 
import  j  ava . awt . event . * ; 
import  java.util.*; 
import  j  ava . io . * ; 


/** 

*  This  class  is  used  to  create  the  ChangeAddressBean  GUI  panel 

* 

*  ©authors  Murat  Akbay  &  Steve  Lewis 
*/ 

public  class  ChangeAddressBean  extends  JPanel  implements 
ActionListener{ 

XYLayout  xYLayoutl  =  new  XYLayout ( ) ; 

JPanel  dataPanel  =  new  JPanel (); 

JPanel  labelPanel  =  new  JPanel (); 

JLabel  addressLabel  =  new  JLabelO; 

JPanel  headerPanel  =  new  JPanel (); 

JLabel  changeSailorLabel  =  new  JLabelO; 

GridBagLayout  gridBagLayoutS  =  new  GridBagLayout ( ) ; 

XYLayout  xYLayout2  =  new  XYLayout ( ) ; 

JPanel  buttonPanel  =  new  JPanel {); 

JPanel  blankPanel  =  new  JPanel (); 

JButton  submitButton  =  new  JButtonO; 

JButton  clearButton  =  new  JButtonO; 

XYLayout  xYLayoutS  =  new  XYLayout ( ) ; 

JLabel  cityLabel  =  new  JLabelO; 

JLabel  stateLabel  =  new  JLabelO; 

JLabel  countryLabel  =  new  JLabel ( ) ; 

JLabel  postalLabel  =  new  JLabelO; 

JLabel  homeLabel  =  new  JLabelO; 

JLabel  sailorLabel  =  new  JLabelO; 

JText Field  jTextFieldl  =  new  JText Field (); 

JTextField  homePhoneField  =  new  JTextFieldO; 

JTextField  sailorSsnField  =  new  JTextFieldO; 

JTextField  addressField  =  new  JTextFieldO; 

JTextField  cityField  =  new  JTextFieldO ; 

JTextField  stateField  =  new  JTextFieldO ; 

JTextField  countryField  =  new  JTextFieldO; 

JTextField  postalField  =  new  JTextFieldO; 

JButton  cancelButton  =  new  JButtonO; 

GridBagLayout  gridBagLayoutl  -  new  GridBagLayout 0 ; 
private  Gui  parentApplet ; 
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/** 

*  This  is  the  constructor  used  to  create  the 

*  ChangeAddressBean  panel  GUI  interface 

* 

*  @param  Gui  parent 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors. 
*/ 

public  ChangeAddressBean (Gui  parent)  { 
parentApplet  =  parent; 
try  { 

jblnit  0 ; 

} 

catch  (Exception  ex)  { 
ex.printStackTrace 0 ; 

} 

} 


*  This  method  is  used  to  initialize  the  ChangeAddressBean  panel 

* 

*  ©pa ram  none 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

private  void  jblnit ()  throws  Exception  { 

changeSailorLabel.setText {"  CHANGE  SAILOR  ADDRESS"); 

submitButton . setText ( ” SUBMIT" ) ; 

clearButton . setText ( "CLEAR" ) ; 

cityLabel . setText ( "  CITY" ) ; 

cityLabel . setOpaque (true) ; 

stateLabel . setText ( "  STATE" ) ; 

stateLabel . setOpaque (true) ; 

countryLabel . setText ( "  COUNTRY" ) ; 

countryLabel . setOpaque (true) ; 

pos talLabel . setText ( "  POSTAL  CODE "); 

postalLabel. setOpaque (true) ; 

homeLabel . setText ( "  HOME  PHONE " ) ; 

homeLabel . setOpaque (true) ; 

sailorLabel. setText ("  SAILOR  SSN")  ; 

sailorLabel . setOpaque (true) ; 

j  TextFieldl . setText ( "  " ) ; 

homePhoneField . setText ( "  " ) ; 

sailorSsnField . setText ( "  " ) ; 

cancelButton. setText ( "CANCEL" ) ; 

addressField. setText ( "  " ) ; 

cityField . setText ( "  " ) ; 

stateField. setText ("  ") ; 

countryField. setText ( "  " ) ; 

po'stalField.  setText  ( "  " )  ; 

buttonPanel . setLayout (gridBagLayoutl) ; 
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headerPanel . setLayout (gridBagLayout3) ; 
xYLayoutl.setHeight (460) ; 
addressLabel . setText ( "  NEW  ADDRESS” ) ; 
addressLabel . setOpaque (true) ; 
labelPanel .setLayout (xYLayout3)  ; 
dataPanel . setLayout (xYLayout2) ; 
xYLayoutl . set Width (636) ; 
this . setLayout (xYLayoutl) ; 

this .add (dataPanel,  new  XYConstraints (34 ,  55,  575,  337)); 
dataPanel.  add  (labelPanel,  new  XYConstraints  (8 ,  12,  138,  316)); 
labelPanel.  add  (addressLabel,  new  XYConstraints  (0,  0,  130,  24)); 
labelPanel. add (cityLabel,  new  XYConstraints  (0 ,  32,  130,  24)); 
labelPanel  .add (stateLabel,  new  XYConstraints  (0,  64,  130,  24)); 
labelPanel  .add (countryLabel,  new  XYConstraints  (0,  95,  130,  24)); 
labelPanel  .add (postalLabel,  new  XYConstraints  (0,  127,  130,  24)); 
labelPanel  .add (homeLabel,  new  XYConstraints  (0,  159,  130,  24)); 
labelPanel. add (sailorLabel,  new  XYConstraints  (0,  191,  130,  24)); 
labelPanel. add (jTextFieldl,  new  XYConstraints  (160,  6,  174,  25)); 
dataPanel  .add  (homePhoneField,  new  XYConstraints  (179, 168, 163 , 27)  )  ; 
dataPanel  .add  (sailorSsnField,  new  XYConstraints  (179, 200, 163 , 27) )  ; 
dataPanel  .add  (addressField,  new  XYConstraints  (179,  9,  163,  27)); 
dataPanel  .add  (cityField,  new  XYConstraints  (179 ,  41,  163,  27)); 
dataPanel  .add (stateField,  new  XYConstraints  (179 ,  73,  163,  27)); 
dataPanel  .add  (countryField,  new  XYConstraints  (179 ,  105,  163,  27)); 
dataPanel. add (postalField,  new  XYConstraints  (179,  137,  163,  27)); 
this,  add  (headerPanel,  new  XYConstraints  (34,  9,  575,  40)); 
headerPanel  .add (changeSailorLabel,  new  GridBagConstraints2 

(0,  0,  1,  1,  0.0,  0.0, 
GridBagConstraints . WEST, 
GridBagConstraints  .NONE, 
new  Insets 

(7,  153,  6,  136),  98,  12)); 

this  .add  (buttonPanel,  new  XYConstraints  (34 ,  398,  575,  50)); 
buttonPanel .  add  (blankPanel ,  new  GridBagConstraints2 

(3,  0,  1,  1,  1.0,  1.0, 
GridBagConstraints . CENTER, 
GridBagConstraints .BOTH, 
new  Insets 

(7,  18,  8,  46) ,  253,  25) ) ; 

buttonPanel  .add  (submi tBut ton,  new  GridBagConstraints 2 

(0,  0,  1,  1,  0.0,  0.0, 
GridBagConstraints . CENTER, 
GridBagConstraints . NONE , 
new  Insets 

(15,  8,  12,  0)  ,0,0))  ; 

buttonPanel  .add (clearButt on,  new  GridBagConstraints2 

(1,  0,  1,  1,  0.0,  0.0, 
GridBagConstraints . CENTER, 
GridBagConstraints . NONE , 
new  Insets 

(15,  16,  12,  0) ,0,0))  ; 

buttonPanel .  add  (cancelButton,  new  GridBagConstraints2 
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(2,  0,  1,  1,  0.0,  0.0, 
GridBagConstraints . CENTER, 
GridBagConstraints .NONE, 
new  Insets 

(15,  15,  12,  0)  ,  0,  0)  )  ; 

submitButton.addActionListener  (this)  ; 
clearButton. addActionListener (this)  ; 
cancelButton. addActionListener  (this)  / 

} 


/** 

*  This  method  is  used  perform  the  actions  required  based  on  what  the 

*  user  enters  for  the  database  modification. 

* 

*  ©param  e  action  performed  by  the  user 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  void  actionPerf ormed  (ActionEvent  e)  { 

String  command  =  e.getActionCommandO  ; 

if  (command. equals  ("SUBMIT")  )  { 

Navy.adressStruct  myAddressStruct  =  new  Navy.adressStruct  ()  ; 
myAddressStruct  .adress  =  addressField.getText  ()  .  trim()  ; 
myAddressStruct  .city  =  cityField.getText  ()  .  trimO  ; 
myAddressStruct  .state  =  stateField.getText  ()  .trimO  ; 
myAddressStruct  .country  =  countryField.getText().trim(); 
myAddressStruct  .postalCode  =  postalField.getText().trim(); 
myAddressStruct  .homePhone  =  homePhoneField.getText().trim(); 
myAddressStruct .ssn  =  sailorSsnField.getText  ()  .trimO  ; 
parentApplet .  corbaBean .  submitAddressChange  (myAddressStruct )  ; 

} 

else  if (command. equals ("CLEAR") )  { 
addressField . setText ( " " ) ; 
cityField. setText ( " " ) ; 
stateField . setText (""); 
coxintryField.  setText  ("")  ; 
postalField . setText ( " " )  ; 
homePhoneField . setText ( " " )  ; 
sailorSsnField . setText ( " " )  ; 

} 

else  if (command. equals ("CANCEL") ) { 
parentApplet . shows witch ( ) ; 

} 

} 
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//-- . 

//  Filename 
//  Authors 
//  Date 
//  Compiler 
// - 


GetDaysDeployedBean. java 
Murat  Akbay  &  Steve  Lewis 
10/17/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


import  java.awt.*; 
import  borland . jbcl . layout . * ; 
import  com.sun. java. swing.*; 
import  j  ava . awt . event . * ; 
import  j ava. util.*; 


/** 

*  This  class  is  used  to  create  the  GetDaysDeployedBean  GUI  panel 

* 

*  ©authors  Murat  Akbay  &  Steve  Lewis 
*/ 

public  class  GetDaysDeployedBean  extends  JPanel  implements 
ActionListener{ 

XYLayout  xYLayoutl  =  new  XYLayoutO; 

JPanel  displayPanel  =  new  JPanel (); 

JPanel  headerPanel  =  new  JPanel (); 

JLabel  jLabelS  =  new  JLabeK); 

GridBagLayout  gridBagLayoutS  =  new  GridBagLayout ( ) ; 
GridBagLayout  gridBagLayoutS  =  new  GridBagLayout () ; 

JButton  backButton  =  new  JButtonO  ; 

JPanel  backPanel  -  new  JPanel {); 

GridBagLayout  gridBagLayout4  =  new  GridBagLayout () ; 

JButton  clearButton  =  new  JButton { ) ; 

JPanel  clearPanel  =  new  JPanel (); 

GridBagLayout  gridBagLayoutG  =  new  GridBagLayout ( ) ; 
GridBagLayout  gridBagLayout?  =  new  GridBagLayout () ; 

JButton  submitButton  =  new  JButtonO; 

JPanel  submitPanel  =  new  JPanel (); 

GridBagLayout  gridBagLayoutS  =  new  GridBagLayout () ; 

JButton  cancelButton  =  new  JButton ( ) ; 

JPanel  cancelPanel  =  new  JPanel (); 

CardLayout  cardLayoutl  =  new  CardLayout ( ) ; 

GetDaysDeployedPanell  panell  ; 

GetDaysDeployedPanel2  panel2  ; 
private  Gui  parentApplet ; 
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/** 

*  This  is  the  constructor  used  to  create  the 

*  GetDaysDeployedBean  panel  GUI  interface 

* 

*  ©param  Gui  parent 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors. 
*/ 

public  GetDaysDeployedBean (Gui  parent)  { 
parentApplet  =  parent; 

panell  =  new  GetDaysDeployedPanell  (parentApplet)  ; 
try  { 

jblnit  0  ; 

} 

catch  (Exception  ex)  { 
ex. prints tackTrace 0 ; 

} 

} 


/** 

*  This  method  is  used  to  initialize  the  GetDaysDeployedBean  panel 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

private  void  jblnit ()  throws  Exception  { 
backButton.addActionListener (this) ; 
clearButton . addActionListener (this) ; 
siibmitButton.addActionListener  (this)  ; 
cancelButton. addActionListener  (this)  ; 

j  Labels . set Text ( "  GET  DAYS  DEPLOYED  FORM" )  ; 

backButton. setText ( "BACK" ) ; 

backBut ton. setOpaque (true) ; 

clearButton. setText ( "CLEAR" ) ; 

submitButton . setText ( " SUBMIT" ) ; 

submitButton. setOpaque (true) ; 

cancelButton. setText ( "CANCEL" ) ; 

cancelButton. setOpaque (true) ; 

displayPanel . setLayout (cardLayoutl) ; 

xYLayoutl . setHeight (480)  ; 

displayPanel .add ( "panell" ,  panell) ; 

cardLayoutl . show (displayPanel , "panell " ) ; 

xYLayoutl. setWidth (668)  ; 

this . setLayout (xYLayoutl ) ; 

this. add (displayPanel,  new  XYConstraints (38 ,  49,  606,  362)); 
this. add (headerPanel,  new  XYConstraints (38 ,  4,  584,  -1)); 
headerPanel.add(jLabel8,  new  GridBagConstraints2 

(0,  0,  1,  1,  0.0,  0.0, 
GridBagConstraints . CENTER, 
GridBagConstraints .NONE, 
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new  Insets 

(5,  157,  8,  132) ,  98,  12)  )  ; 

this. add (backPanel,  new  XYConstraints (141,  413,  95,  40)); 
backPanel . add (backButton,  new  GridBagConstraints2 

(0,  0,  1,  1,  0.0,  0.0, 
GridBagConstraints . CENTER , 
GridBagConstraints .NONE, 
new  Insets 

(0,  0,  0,  0) ,0,0))  ; 

this. add (clearPanel,  new  XYConstraints (246 ,  413,  95,  40)); 
clearPanel . add (clearButton,  new  GridBagConstraints2 

(0,  0,  1,  1,  0.0,  0.0, 
GridBagConstraints . CENTER, 
GridBagConstraints . NONE , 
new  Insets 

(0,  0,  0,  0) ,0,0))  ; 

this. add (submitPanel,  new  XYConstraints  (346,  413,  95,  40)); 
submitPanel .  add  ( submit  But  ton ,  new  GridBagConstraint  s2 

(0,  0,  1,  1,  0.0,  0.0, 
GridBagConstraints . CENTER, 
GridBagConstraints .NONE, 
new  Insets 

(0,  0,  0,  0) ,0,0))  ; 

this .add (cancelPanel,  new  XYConstraints (449 ,  413,  95,  40)); 
cancelPanel .add (cancelButton,  new  GridBagConstraints2 

(0,  0,  1,  1,  0.0,  0.0, 
GridBagConstraints . CENTER, 
GridBagConstraints . NONE , 
new  Insets 

(0,  0,  0,  0) ,0,0))  ; 


} 


/** 

*  This  method  is  used  perform  the  actions  required  based  on  what  the 

*  user  enters  for  the  database  modification. 

* 

*  ©param  e  action  performed  by  the  user 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors. 

*/ 

public  void  actionPerformed (ActionEvent  e)  { 

String  command  =  e .getActionCommand () ; 

if (command. equals ("BACK”) ) { 

cardLayoutl.show(displayPanel, "panell") ; 

} 

else  if (command. equals ("SUBMIT") )  { 

String  []  entryString  =  panell  .getInputsO; 
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string  []  columnNames  =  {"Tango  No.”,  "Date  Of  Departure", 

"Rank  Rate", "F.  Name", 

" L .  Name " , " Command  Name " , 

"TAD  Title", "TAD  Date  Of  Arrival", 
"TAD  Date  Of  Departure", 
"Destination  Command"}; 


Navy . deployment Struct []  result  = 

parent Applet . corbaBean. getDaysDeployed 
(entrystring [0] , entrystring [1]  , 
entrystring [2] , entrystring [3] ) ; 

if (  result  ==  null  ) { 

JOptionPane .  showMessageDialog 

(parent Applet, "Error  in  executing  query","", 
JOptionPane. ERROR  MESSAGE  ); 

}  ,  - 
int  resultLength  =  result . length; 
if (  resultLength  ==  0  ) { 

JOptionPane . showMessageDialog 

(parent Applet,  "The  cjuery  returned  no  results" 

, " " ,  OptionPane . INFORMATION  MESSAGE) 


} 

else{ 

Object  []  [] 


QueryResult  =  new  Object [resultLength] [10] 


IX  < 


} 


for (int  ix  =  0; 

QueryResult [ix] [0] 

QueryResult [ix] [1] 

QueryResult [ix] [2] 

QueryResult [ix] [3] 

QueryResult [ix] [4] 

QueryResult [ix] [5] 

QueryResult [ix] [6] 

QueryResult [ix] [7] 

QueryResult [ix] [8] 

QueryResult [ix] [9] 

} 

panel2  =  new  GetDaysDeployedPanel2 

(parentApplet , QueryResult , columnNames) 
displayPanel . add ( "panel2 " ,  panel2 ) ; 
cardLayoutl .  show  (displayPanel ,  "panel2  " )  ; 


resultLength  ;  ix++  ) { 

=  result [ix] . tangoNumber; 

=  result [ix] .dateDepart; 

=  result  [ix] .rankRate; 

=  result  [ix]  .firstName; 

=  result [ix] . lastName; 

=  result [ix] .commandName; 

=  result [ix] .title ; 

=  result [ix] .dateArrival; 

=  result [ix] .dateDeparture; 
=  result [ix] .comm; 


} 

else  if (command. equals ("CLEAR") ) { 
panell . clear ( ) ; 


} 

else  if  (command. equals  ("CANCEL")  )  { 
parentApplet  .showSwitchO  ; 

} 

} 
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// - 

//  Filename 
//  Authors 
//  Date 
//  Compiler 
// - 


GetDaysDeployedPanell . j  ava 
Murat  Akbay  &  Steve  Lewis 
10/17/1998 

JDK1,1.6  with  Symantec  JIT  Compiler 


import  j  ava . awt . * ; 
import  borland . j bcl . layout . * ; 
import  com .  sxin .  j  ava .  swing .  *  ; 
import  j  ava . awt . event . *  ; 


*  This  class  is  used  to  create  the  GetDaysDeployedPanell  GUI  panel 

* 

*  ©authors  Murat  Akbay  &  Steve  Lewis 
*/ 

public  class  GetDaysDeployedPanell  extends  JPanel  { 
private  String  sample  =  "Sample”; 

XYLayout  xYLayoutl  =  new  XYLayout  ( )  ; 

JPanel  j Pane 11  =  new  JPanel (); 

JPanel  jPanel2  =  new  JPanel (); 

JLabel  NameLabel  =  new  JLabelO; 

JLabel  sDateLabel  =  new  JLabelO; 

JTextField  lastNameField  =  new  JTextField ( ) ; 

JTextField  startDateField  =  new  JTextFieldO ; 

XYLayout  xYLayout2  =  new  XYLayout  ( )  ; 

XYLayout  xYLayout3  =  new  XYLayout  ( )  ; 

JLabel  jLabell  =  new  JLabelO; 
private  Gui  parentApplet ; 

JLabel  ssnLabel  =  new  JLabelO; 

JLabel  eDateLabel  =  new  JLabelO; 

JTextField  stopDateField  =  new  JTextFieldO; 

JTextField  ssnField  =  new  JTextFieldO; 

JLabel  j  Labe  12  =  new  JLabelO; 


/** 

*  This  is  the  constructor  used  to  create  the 

*  GetDaysDeployedPanell  panel  GUI  interface 

* 

*  ©param  Gui  parent 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors . 
*/ 

public  GetDaysDeployedPanell  (Gui  parent)  { 
parentApplet  =  parent ; 
try  { 

jblnit  0  ; 

} 

catch  (Exception  ex)  { 
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ex.printStackTrace 0 ; 


/** 

*  This  method  is  used  to  initialize  the  GetDaysDeployedPanell  panel 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  Default  Exception  to  catch  all  errors . 

*/ 

private  void  jblnitO  throws  Exception  { 
j Label 1 . setText 

("Enter  the  sailor\*s  name  or  social  security  number  and  the 
time  interval  ")  ; 
ssnLabel . setOpaque (true) ; 
eDateLabel.setOpaque(true) 7 
stopDateField . setText ( "  " ) 7 
ssnField . setText ( "  " ) 7 

jLabel2. setText ("and  click  on  the  submit  button.") 7 

eDateLabel . setText ( "  STOP  DATE " ) 7 

ssnLabel . setText ( "  SAILOR  SSN" ) 7 

xYLayoutl . setHeight (360)  7 

NameLabel. setOpaque (true) 7 

sDateLabel . setOpaque (true) 7 

lastNameField . setText ( "  " ) 7 

startDateField . setText ( "  " ) 7 

SDateLabel . setText ( "  START  DATE" ) 7 

NameLabel . setText ( "  LAST  NAME " ) 7 

j  Panel2 . setLayout (xYLayoutS ) 7 

j  Panel 1 . setLayout {xYLayout2 ) ; 

xYLayoutl. setWidth (606)  7 

this.setLayout (xYLayoutl) 7 

thi  s.  add  (j  Panel  1,  new  XYConstraints  (31,  1,  574,  359)),- 
jPanell.add(  jPanel2,  new  XYConstraints  (-3 ,  5,  189,  198)),* 
jPanel2  .add (NameLabel,  new  XYConstraints  (25,  99,  130,  26)),- 
jPanel2  .add (sDateLabel,  new  XYConstraints  (25,  138,  130,  26)),- 
j  Panel  2  .add  (ssnLabel,  new  XYConstraints  (25,  60,  130,  26)),- 
jPanel2  .add (eDateLabel,  new  XYConstraints  (25,  177,  130,  26)),- 
jPanell.  add  (lastNameField,  new  XYConstraints  (189,  105,  163,  27)),* 
jPanell.  add  (StartDateField,  new  XYConstraints  (189,  141,  163,  27)),- 
jPanell.add(  jLabell,  new  XYConstraints  (11,  215,  501,  48)),- 
jPanell. add (stopDateField,  new  XYConstraints (189,  177,  163,  21))} 
jPanell.  add  (ssnField,  new  XYConstraints  (189 ,  69,  163,  27)),* 
jPanell  .add  (jLabel2  ,  new  XYConstraints  (11 ,  264,  498,  44)),- 

} 
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j  'k'k 

*  This  method  is  used  to  take  the  inputs  that  the  user  enters 

*  in  the  GetDaysDeployedPanell  panel 

* 

*  ©param  none 

*  ©return  replystring  which  contains  the  user  inputs 

*  ©exception  none 

*/ 

public  String []  getlnputs(){ 

String []  replystring  =  new  String[4]; 
replystring [0]  =  ssnField.getText  ()  . trimO  ; 
replystring  [1]  =  lastNameField.getTextO.trimO; 
replystring  [2]  =  startDateField.getText  ()  .trimO  ; 
replystring [3]  =  stopDateField.getText  ()  .trimO  ; 
return  replystring; 

} 


/** 

*  This  method  is  used  to  clear  the  fields  on  the 

*  GetDaysDeployedPanell  panel 

* 

*  ©param  none 

*  ©return  void 

*  ©exception  none 
*/  • 

piiblic  void  clear  0  { 

ssnField . setText { " " ) ; 
lastNameField . setText ( " " ) ; 
startDateField. setText ( " " ) ; 
stopDateField . setText ( " " ) ; 

} 

} 
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// - 

//  Filename 
/ /  Authors 
//  Date 
//  Compiler 
// - 


GetDaysDeployedPanel2  .java 
Murat  Akbay  &  Steve  Lewis 
10/17/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


import  j  ava . awt . * ; 
import  borland. jbcl. layout.*; 
import  com . sun . j  ava . swing . * ; 
import  com . sun . j  ava . swing . table . * ; 
import  j  ava . awt . event . * ; 
import  borland . db swing . * ; 


/** 

*  This  class  is  used  to  display  the  data  returned  from  the  user 

*  defined  query  submitted  through  the  GetDaysDeployedPanel2  panel 

* 

*  ©authors  Murat  Akbay  &  Steve  Lewis 
*/ 

public  class  GetDaysDeployedPanel2  extends  JPanel  { 

BorderLayout  borderLayoutl  =  new  BorderLayout ( ) ; 
private  Gui  parentApplet ; 


!  -k-k 

*  This  constructor  is  used  to  create  the  GetDaysDeployedPanell  GUI 

*  panel 

* 

*  ©params  Gui  parent,  Object  [] []  inData,  String []  inColuranNames 

*  ©returns  none 

*  ©exceptions  none 
*/ 

public  GetDaysDeployedPanel2 

(Gui  parent,  Ob  j  ect  []  []  inData,  String[]  inColumnNames)  { 
parentApplet  =  parent ; 
this.setLayout (borderLayoutl) ; 

final  JTable  table  =  new  JTable (inData, inColumnNames) ; 

table. setPreferredScrollableViewportSize (new  Dimension (600, 360) ) ; 

table .  setAutoResizeMode  ( JTable  .AUTO_RES I ZE_OFF)  ; 

TableColumn  column  =  null; 
for  (int  i  =  0;  i  <  10;  i++)  ( 

column  =  table.getColumnModel().getColumn(i); 
column. setMinWidth (100) ; 

} 

add  (JTable .  createScrollPaneForTable  (table)  ,  BorderLayout .  CENTER)  ; 

} 
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// - 

//  Filename 
//  Authors 
//  Date 
/ /  Compiler 
// - 


Gui . html 

Murat  Akbay  &  Steve  Lewis 
10/17/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


<!  This  html  file  is  downloaded  to  the  client  web-browser  and  is  used 
by  the  browser  to  create  the  applet  which  will  serve  as  the  client 
front-end  to  the  EIS.  This  will  work  with  I.E.  4.0+  and  Netscape 
4.5+  web-browsers- -> 

<HTML> 

<HEAD> 

<TITLE>  CORBAWORKS  </TITLE> 

<B0DY  BACKGROUND="spark&quill  .gif "> 

<P> 

<!--  The  following  code  is  specified  at  the  beginning  of  the  <BODY> 
tag .  - - > 

< CENTER > 

<OBJECT  classid="clsid:8AD9C840-044E-llDl-B3E9-00805F499D93" 
width="790"  height="596" 

codebase="http : //java . s\in . com/products/plugin/l . 1/ 

jinstall-ll-win32.cab#Version=l, 1, 0, 0"> 
<PARAM  NAME="code"  VALUE= "Gui. class" > 

<PARAM  NAME="type"  VALUE="application/x- java-applet ;version=l . 1" > 
<PARAM  NAME= "org . omg . CORBA . ORBClass " 

VALUE="com.  visigenic .  vbroker .  orb .  ORB"  > 
<PARAM  NAME=ORBservices  VALUE=CosNaming> 

<PARAM  NAME=SVCnameroot  VALUE=JavaCorba> 

</CENTER> 

< COMMENT > 

<EMBED  type="application/x-java-applet;version=l .1" 

WIDTH="790"  HEIGHT="596" 

HSPACE="100"  ALIGN="Top"  CODE= "Gui . class " 
pluginspage="http: //java. sun. com/products/plugin/1 . 1/ 

plugin- install .html 

org . omg . CORBA . ORBClass= " com . visigenic . vbroker . orb . ORB " 
ORBservices=CosNaming 
S VCnamer oot = JavaCorba  > 

<NOEMBED> 

</ COMMENT > 

No  JDK  1 . 1  support  for  APPLET ! ! 

< /NOEMBED > < /EMBED> 

</OBJECT> 


</P> 

</BODY> 

</HTML> 
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Hr . . 

//  Filename 
//  Authors 
//  Date 
//  Compiler 
// - 


Guijar.html 

Murat  Akbay  &  Steve  Lewis 
10/17/1998 

JDKl.1.6  with  Symantec  JIT  Compiler 


<!  This  html  file  is  downloaded  to  the  client  web-browser  and  is  used 
by  the  browser  to  create  the  applet  which  will  serve  as  the  client 
front-end  to  the  EIS.  This  will  work  with  I.E.  4,0+  and  Netscape 
4.5+  web-browsers.  If  this  file  is  used  by  the  browser,  additional 
savings  of  download  time  will  occur,  since  the  files  that  make  up 
the  applet  are  downloaded  in  a  single  session, --> 

<HTML> 

<HEAD> 

<TITLE>  CORBAWORKS  </TITLE> 

<BODY  BACKGROUND^  "  spark&quill .  gif  ”  > 

<P> 

<!--  The  following  code  is  specified  at  the  beginning  of  the  <BODY> 
tag .  - - > 

< CENTER > 

<OBJECT  classid="clsid:8AD9C840-044E-llDl-B3E9-00805F499D93" 
width=”775"  height="596" 

codebase="http : //java . sun. com/products/plugin/1 . 1/ 

jinstall-ll-win32 . cab#Version=l , 1, 0, 0”> 

<PARAM  NAME="code”  VALUE="Gui  .  class "> 

<PARAM  NAME=" archive"  VALUE="Gui  .  jar " > 

<PARAM  NAME=”type”  VALUE=  "appli cat ion/x- java -apple t ; vers ion=l .  1” > 
<PARAM  NAME=”org.omg.CORBA.ORBClass” 

VALUE= ” com . visigenic . vbroker . orb . ORB " > 

<PARAM  NAME=ORBservices  VALUE = Co sNaming> 

<PARAM  NAME=SVCnameroot  VALUE=JavaCorba> 

< / CENTER> 

< COMMENT > 

<EMBED  type="application/x“ java -applet ; versions 1 .1" 

WIDTHS "775”  HEIGHTS "596" 

HSPACE="100"  ALIGNS  "Top"  CODE=:  "Gui  .  class  " 

ARCHIVES " Gui .jar" 

pluginspage="http :  /  /java .  sun.  com/product s /plugin/ 1 . 1/ 

plugin-install . html 

org .  omg .  CORBA.ORBClasss”com.  visigenic  .vbroker .  orb .  ORB" 
ORBservicessCosNaming 
S VCname  root  s JavaCorba  > 

<NOEMBED> 

</ COMMENT > 

No  JDK  1 . 1  support  for  APPLET ! 1 
</NOEMBED></EMBED> 

</OBJECT> 

</P> 

</BODY> 

</HTML> 
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1 .  Defense  T echnical  Information  Center . 2 

8725  John  J.  Kingman  Road,  Ste  0944 

Ft.  Belvoir,  VA  22060-6218 

2.  Genelkurmay  Baskanligi . 1 


Personel  Baskanligi 
Bakanliklar 
Ankara,  TURKEY 

3 .  Kara  Kuwetleri  Komutanligi . 1 

Personel  Daire  Baskanligi 

Bakanliklar 
Ankara,  TURKEY 

4.  Kara  Kuwetleri  Komutanligi . 1 

Kutuphanesi 

Bakanliklar 
Ankara,  TURKEY 

5.  Kara  Harp  Okulu . 1 . 2 

Kutuphanesi 

Dikmen 

Ankara,  TURKEY 

6.  Dudley  Knox  Library . 2 

Naval  Postgraduate  School 

411  Dyer  Rd. 

Monterey,  CA  93943-5101 

7.  Commanding  Officer . 1 

(Attn:  Code  30,  CDR  Zellman) 

Naval  Information  Warfare  Activity 
9800  Savage  Rd. 

Ft  Meade,  MD  20755-6000 

8 .  Commanding  Officer . 1 

(Attn:  Code  00,  CDR  Arbogast) 

Naval  Security  Group  Activity,  Pensacola  Florida 
475  Jones  Street 
NTTC  Cony  Station 
Pensacola,  FL  325 1 1 
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9.  Commander  Naval  Security  Group  Command . 1 

Naval  Security  Group  Headquarters 

9800  Savage  Road,  Suite  6585 

Fort  George  G.  Meade,  MD  20755-6585 


10.  Chairman,  Code  CS . 1 

Naval  Postgraduate  School 

Monterey,  CA  93943-5101 

11.  Dr.  C.  Thomas  Wu,  Code  CSAVu . 1 

Naval  Postgraduate  School 

Monterey,  CA  93943-5100 

1 2 .  LCDR  Chris  Eagle,  Code  EC/Lt . 1 

Naval  Postgraduate  School 

Monterey,  CA  93943-5100 

13.  ILT  Murat  Akbay . 1 

218/8  Sokak  Emek  Apt.  No.  19 

Bomova,  Izmir,  TURKEY 

14.  LT  Steven  Lewis . 1 

4921  E.  138*^  St  SW 

Edmonds,  WA  98026 
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